Ethora MCP CLI

Bind a saved agent as the active AI bot for the current app — copies the agent's config onto the app's bot, replacing whatever was there before (POST /v2/agents/:agentId/activate). Does not by itself set status: "on" — pair with ethora-bot-enable-v2 if needed. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 404 agentId not an agent of the current app. Related: verify with ethora-bot-get-v2.

Duplicate an existing saved agent into a new agent, optionally overriding its name/slug/summary (POST /v2/agents/:agentId/clone). The source agent is unchanged; the new clone becomes the session's current agent context. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 404 source agentId not found; 422 overridden slug collides.

Create a new reusable saved agent — a named bot definition (prompt + LLM + RAG settings + identity) that can later be activated onto any app (POST /v2/agents). Does not activate it — call ethora-agents-activate-v2 for that. Returns the created agent including its id. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 422 validation (e.g. duplicate slug, unsupported llmProvider/llmModel).

Fetch one reusable saved agent's full config by id (GET /v2/agents/:agentId) — prompt, LLM, RAG settings, visibility. Also sets this agent as the session's current agent context (no server-side change). Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 404 agentId not an agent of the current app. Related: get ids from ethora-agents-list-v2.

List the reusable saved agents owned by the current app (GET /v2/agents) — a saved agent is a reusable bot definition. Returns an array of agents with ids, names, and config. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 not in app-token mode or invalid appToken; empty list if the app has no saved agents.

Update fields on an existing reusable saved agent (PUT /v2/agents/:agentId). Partial update — omitted fields are left unchanged. If the agent is currently activated on the app, changes take effect on the live bot. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 404 agentId not an agent of the current app; 422 validation. Related: get agentId from ethora-agents-list-v2.

Create a new Ethora app (tenant) owned by the currently logged-in user. Allocates a fresh 24-char hex appId and sets the caller as owner; counts against the owner's plan limit. Returns the new app object including appId. Auth: user-auth mode, active session (ethora-user-login first). Errors: 401 not logged in; 402/403 plan limit reached; 422 invalid displayName. Related: server-side provisioning uses ethora-b2b-app-create.

Create a new chat room (MUC room) inside an app the caller owns. If pinned: true the room is added to the app's default rooms (new users auto-join; existing users are not). Returns the new room object including its JID. Auth: user-auth mode, active session; the caller must own the app. Errors: 401 not logged in; 403 not owner; 404 unknown appId; 422 invalid title.

Permanently delete a chat room from an app the caller owns — removes the MUC room, its message archive, and all member affiliations. Irreversible; gated behind ETHORA_MCP_ENABLE_DANGEROUS_TOOLS=true. Auth: user-auth mode, active session; the caller must own the app. Errors: 401 not logged in; 403 not owner; 404 chatJid not a room in the app.

List the default chat rooms (MUC rooms) of the currently selected Ethora app — every new user auto-joins these. Returns rooms with their JIDs and titles. Auth: user-auth mode, active session; operates against the app set via ethora-app-select. Errors: 400 no app currently selected; 401 not logged in. Related: ethora-app-get-default-rooms-with-app-id to pass appId explicitly.

List the default chat rooms of a specific Ethora app, passed via appId (or the currently selected app). Returns rooms with their JIDs and titles. Auth: user-auth mode, active session; the caller needs read access (ownership or room membership). Errors: 400 no appId and none selected; 401 not logged in; 403 no read access; 404 unknown appId.

List all Ethora apps (tenants) owned by the currently logged-in user. Returns an array with appId (24-char hex), displayName, domainName, ownership and bot-status metadata. Auth: user-auth mode, active session (ethora-user-login first). Errors: 401 not logged in; empty list if the user owns no apps. Related: feed appId into ethora-app-update / ethora-app-select.

Set the current app context for this session so app-scoped tools can omit their appId argument. Stores currentAppId and, if given, appToken (which defaults the auth mode to app-token unless authMode overrides). Auth: none required to set the context. Errors: effectively none — a non-existent appId is not validated here; the first app-scoped API call surfaces the 404. Related: pairs with ethora-auth-use-app.

Mint a new app token for an app. The secret token value is returned exactly once and cannot be retrieved again — capture it immediately. Returns the new token including its one-time secret value and tokenId. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode; 400 no appId and none selected; 404 unknown appId. Related: manage with ethora-app-tokens-list-v2 / -rotate-v2 / -revoke-v2.

List the app tokens issued for an app — metadata only (tokenId, label, created/rotated timestamps, status); the secret token values are never returned (only shown once at create/rotate time). Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode; 400 no appId and none selected; 404 unknown appId.

Permanently revoke an app token by tokenId — it stops working immediately; any client, SDK, or MCP session still using it gets auth failures. No replacement is issued. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode; 400 no appId and none selected; 404 unknown appId. Related: get tokenId from ethora-app-tokens-list-v2; ethora-app-tokens-rotate-v2 for revoke-and-replace.

Rotate an app token: revoke an existing token and issue a replacement in one step. The old tokenId is revoked immediately — anything using it stops working at once. The new secret value is returned exactly once — capture it immediately. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode; 400 no appId and none selected; 404 unknown appId or tokenId. Related: ethora-app-tokens-revoke-v2 to revoke without a replacement.

Update mutable fields on an app the caller owns (displayName, domainName, appDescription, primaryColor, botStatus). Partial update — omitted fields are left unchanged. Auth: user-auth mode, active session; the caller must own the app. Errors: 401 not logged in; 403 not owner; 404 unknown appId; 422 validation (e.g. domainName taken, primaryColor not #RRGGBB).

Switch this session's active auth mode to app-token, so subsequent app-scoped calls authenticate with the configured appToken. Auth: requires an appToken to already be configured (via ethora-configure, ETHORA_APP_TOKEN env, or ethora-app-select). Errors: returns an error if no appToken is configured. Related: use after ethora-app-select.

Switch this session's active auth mode to B2B, so subsequent calls authenticate as a tenant actor via the x-custom-token header. Auth: requires a b2bToken (JWT with type=server) to already be configured (via ethora-configure or ETHORA_B2B_TOKEN env). Errors: returns an error if no b2bToken is configured. Related: server-side automation — pairs with ethora-b2b-app-create, ethora-users-batch-create-v2, ethora-app-tokens-*-v2.

Switch this session's active auth mode to user-session, so subsequent calls authenticate as a logged-in Ethora user. Auth: the switch needs nothing, but user-auth tools only work once ethora-user-login stores a user token (login also needs a configured appJwt). Errors: none on the switch; downstream tools return 401 until login succeeds. Related: follow with ethora-user-login.

One-call B2B orchestrator: create an app, set it as the current context, index RAG sources, then configure and enable its AI bot. Source ingest and bot activation are best-effort (the app is still created if a later step fails); crawl/embedding continues asynchronously after this returns. Returns a per-step log including the new appId. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken); internally switches to app-token mode for source-ingest steps. Errors: aborts with the partial step log if app creation fails; previous auth mode restored best-effort. Related: rooms+tokens variant is ethora-b2b-app-provision.

Create a new Ethora app (tenant) server-side using B2B auth — the partner/integrator equivalent of ethora-app-create. Allocates a fresh 24-char hex appId; does not create tokens, rooms, or a bot. Returns the new app object including appId. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode or invalid b2bToken; 422 invalid displayName. Related: all-in-one path is ethora-b2b-app-bootstrap-ai / ethora-b2b-app-provision.

One-call B2B orchestrator: create an app, mint one or more app tokens, provision default chat rooms, then configure and enable its AI bot. Later-step failures don't undo earlier steps. Returns a per-step log including appId and the created tokens (returned once — capture them). Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: aborts with the partial step log if app creation fails; previous auth mode restored best-effort. Related: ethora-b2b-app-bootstrap-ai does sources+bot but not tokens/rooms.

Turn on the AI bot for an app via B2B auth (sets botStatus: "on"). The bot only actually responds if a prompt + LLM are configured (see ethora-bot-update-v2) and the backend has an AI service set up. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode; 400 no appId and none selected; 404 unknown appId. Related: full bot config via ethora-bot-update-v2.

Turn the AI bot off for an app (sets bot status: "off") — it stops responding. The configured prompt/LLM/RAG and any activated agent are preserved, so re-enabling restores the same behavior. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId. Related: ethora-bot-enable-v2 to turn back on.

Turn the AI bot on for an app (sets bot status: "on"), optionally setting its trigger. It only actually responds if a prompt + LLM are configured (see ethora-bot-update-v2) and the backend has an AI service. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId. Related: ethora-bot-disable-v2 to turn off.

Read the current AI bot configuration for an app: status, trigger, prompt, greeting, LLM provider/model, RAG settings, widget config. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId. Related: change config with ethora-bot-update-v2.

Configure the AI bot for an app — prompt, LLM, trigger, greeting, RAG behavior, identity, and public widget settings. Partial update — omitted fields are left unchanged. status: "on" activates the bot (best-effort; needs a prompt + LLM and a backend AI service). Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId; 422 validation (e.g. an llmProvider/llmModel not enabled). Related: ethora-bot-get-v2, ethora-agents-activate-v2.

Read the public chat-widget / embed configuration for the current app's bot (GET /v2/bot/widget) — the widget config and public widget URL metadata needed to embed the bot on a website. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 not in app-token mode or invalid appToken. Related: enable/disable via widgetPublicEnabled in ethora-bot-update-v2.

Fetch the current status and per-room results of a broadcast job by jobId (one-shot, no polling). Returns the job object with its state (pending/running/completed/failed). Auth: app-token mode OR B2B mode with an explicit appId — must match the auth used to enqueue the job. Errors: 401/403 wrong auth; 404 unknown jobId. Related: ethora-wait-broadcast-job-v2 for a blocking wait.

Enqueue an asynchronous broadcast job posting a message to one or more chat rooms of an app — returns a jobId; messages are not sent synchronously. Targeting is exclusive: allRooms, chatIds, or chatNames, not a mix. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 400 no target or conflicting targets; 404 unknown appId or room. Related: track with ethora-wait-broadcast-job-v2.

Read the persisted message history of a chat automation session — the conversation produced by ethora-chats-message-v2 and the bot's replies. Returns the most recent messages (up to limit). Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 400 incomplete mode/nickname/roomJid; 404 room/session not found.

Send a message through the app's chat/bot automation surface — useful for testing the bot or driving automated conversations. Posts a real message; if the app's bot is enabled it reacts to it. private mode = 1:1 session keyed by nickname, group mode = room by roomJid. Auth: app-token mode (after ethora-app-select + ethora-auth-use-app). Errors: 401/403 wrong auth; 400 missing roomJid/nickname for the mode; 404 unknown roomJid. Related: read back with ethora-chats-history-v2.

Set the Ethora API URL and credentials for this MCP session. Stores values in memory only; each call merges with omitted fields kept. Alternative to env vars (ETHORA_API_URL / ETHORA_APP_JWT / ETHORA_APP_TOKEN / ETHORA_B2B_TOKEN). Auth: none required — this establishes auth material. Errors: only if a value is structurally invalid. Follow with an ethora-auth-use-* tool to pick the active mode.

Diagnose the session: validate the config is internally consistent for the active auth mode and ping the Ethora API (GET /v1/ping). Returns { state, checks, ping, suggestions }. Auth: none required; report is tailored to whatever credentials are set. Errors: rarely throws — instead returns suggestions and a ping.ok: false block when the API is unreachable.

Permanently delete one of the authenticated user's files by id (DELETE /v2/files/:id). Removes the record and its stored content; not reversible. Auth: user-auth mode with an active user session. Errors: 401 not logged in; 403 not owned by the user; 404 unknown id. Related: get ids from ethora-files-get-v2.

List the authenticated user's files, or fetch one file's metadata by id (GET /v2/files). Returns an array when id is omitted, a single record when given. Auth: user-auth mode with an active user session. Errors: 401 not logged in; 404 unknown id or not owned by the user.

Upload 1–5 files to the authenticated user's Ethora file storage (POST /v2/files). Each upload is a new record (no overwrite-by-name); files passed as base64, 50MB max each. Auth: user-auth mode with an active user session (ethora-user-login first). Errors: 401 not logged in; 413 size limit exceeded; 422 unsupported mime type. Related: manage with ethora-files-get-v2 / ethora-files-delete-v2.

Generate a human-readable runbook listing this server's tool calls in the right order for a B2B bootstrap, with example payloads. Documentation only — does not write any file or execute any step. Auth: none required — pure text generator, no API calls. Errors: effectively none. Related: to actually run the sequence use ethora-run-recipe or ethora-b2b-app-bootstrap-ai.

Generate a ready-to-paste React App.tsx snippet that mounts @ethora/chat-component. Returns { filename: "App.tsx", snippet }; unpassed values are emitted as placeholders. Does not write any file. Auth: none required — pure code generator, no API calls. Errors: effectively none. Security note: the snippet includes appToken inline only as a quickstart convenience — do not ship hardcoded tokens to production.

Generate .env.example templates for the three common Ethora integration targets: the frontend chat component, the backend SDK, and this MCP server. Returns { target, template } when target is given, or { templates } with all three. Placeholder values only; does not write any file. Auth: none required — pure text generator, no API calls. Errors: effectively none.

Task-oriented orientation for this MCP server: explains the three Ethora auth modes (user / app-token / B2B) and recommends next tool calls + recipes based on current session state. Auth: none required — inspects state, no API calls. Errors: effectively none. Related: pass a recommended recipe id to ethora-run-recipe.

Execute a built-in recipe — an ordered sequence of this server's own tool calls — by id. Recipes capture common flows (B2B bootstrap, broadcast, sources ingest). Use dryRun: true to preview resolved steps. Omit recipeId to list runnable recipes for a goal. Auth: depends on the recipe's steps — configure those first (see ethora-help). Errors: stops at the first failing step and returns the partial log; a missing required vars entry fails fast before any step runs.

Remove a previously ingested document from an app's RAG sources by docId (legacy user-auth route). Deletes the document record and its embeddings; not reversible. Auth: user-auth mode, active session; the user must own the app. Errors: 401 not logged in; 403 not owner; 404 unknown docId. Related: get docId from ethora-sources-docs-list-v2; app-token/B2B uses ethora-sources-docs-delete-v2.

Remove a previously ingested document from an app's RAG sources by docId (app-token / B2B variant of ethora-sources-docs-delete). Deletes the document record and its embeddings; not reversible. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId or docId. Related: get docId from ethora-sources-docs-list-v2.

List an app's ingested documents, including each document's id, name, and current RAG tags. Their ids feed ethora-sources-docs-tags-update-v2 and ethora-sources-docs-delete-v2. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId; empty list if nothing has been uploaded. Related: website-sources equivalent is ethora-sources-site-list-v2.

Set the RAG retrieval tags on an ingested document — replaces the document's tag set with the provided tags array (not additive; pass [] to clear all). Tags let the bot's ragTags narrow retrieval. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId or docId. Related: get docId from ethora-sources-docs-list-v2; website-source equivalent is ethora-sources-site-tags-update-v2.

Upload documents (1–5; PDF, text, etc.) into an app's RAG sources (legacy user-auth route). Async — content becomes queryable once indexing finishes; files passed as base64, 50MB max each. Auth: user-auth mode, active session; the user must own the app. Errors: 401 not logged in; 403 not owner; 413 too large; 422 unsupported document type. Related: app-token/B2B flows use ethora-sources-docs-upload-v2.

Upload documents (1–5; PDF, text, etc.) into an app's RAG sources (app-token / B2B variant of ethora-sources-docs-upload). Async — content becomes queryable once indexing finishes; files passed as base64, 50MB max each. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId; 413 too large; 422 unsupported document type. Related: ethora-sources-docs-list-v2, ethora-sources-docs-delete-v2.

Crawl a website URL and ingest its content into an app's RAG sources (legacy user-auth route). Async — pages become queryable once indexing finishes; followLink: true follows in-domain links and can ingest many pages. Auth: user-auth mode, active session; the user must own the app. Errors: 401 not logged in; 403 not owner; 400 malformed url; 404 unknown appId. Related: app-token/B2B flows use ethora-sources-site-crawl-v2.

Crawl a website URL and ingest its content into an app's RAG sources (app-token / B2B variant of ethora-sources-site-crawl). Async — returns once the job is accepted; followLink: true follows in-domain links and can ingest many pages. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 400 malformed url; 404 unknown appId. Related: ethora-sources-site-crawl-v2-wait (block until done).

Crawl a website URL and block until the server finishes — a single-call, long-timeout variant of ethora-sources-site-crawl-v2 (same crawl + embed effect). Returns { done: true, durationMs, result }. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 400 malformed url; 504/timeout if it takes longer than timeoutMs (the job may still complete server-side — check with ethora-sources-site-list-v2).

Bulk-remove crawled URLs (1–100) from an app's RAG sources in one call, matched by exact url strings (legacy owner/admin user-auth route). Deletes each matching source record and its embeddings; not reversible. URLs not present are skipped. Auth: user-auth mode, active session; the user must own the app. Errors: 401 not logged in; 403 not owner; 404 unknown appId. Related: single-URL variant ethora-sources-site-delete-url.

Remove a single crawled URL from an app's RAG sources, matched by its exact url string (legacy user-auth route). Deletes the source record and its embeddings; not reversible. Matches on the exact stored URL string. Auth: user-auth mode, active session; the user must own the app. Errors: 401 not logged in; 403 not owner; 404 url not a crawled source. Related: get the stored value from ethora-sources-site-list-v2.

Remove a single crawled URL from an app's RAG sources, matched by its exact url string (app-token / B2B variant of ethora-sources-site-delete-url). Deletes the source record and its embeddings; not reversible. Matches on the exact stored URL string. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 url not a crawled source. Related: get the stored value from ethora-sources-site-list-v2; bulk-by-id is ethora-sources-site-delete-url-v2-batch.

List an app's crawled website sources, including each source's id, URL, and current RAG tags. Their ids feed ethora-sources-site-tags-update-v2, ethora-sources-site-delete-url-v2-batch, and ethora-sources-site-reindex-v2. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId; empty list if nothing has been crawled.

Re-crawl and re-embed a previously crawled URL by its urlId, refreshing the RAG content for that page (legacy user-auth route). Async — the existing source record is updated in place once indexing finishes. Auth: user-auth mode, active session; the user must own the app. Errors: 401 not logged in; 403 not owner; 404 unknown appId or urlId. Related: get urlId from ethora-sources-site-list-v2; app-token/B2B uses ethora-sources-site-reindex-v2.

Re-crawl and re-embed a previously crawled URL by its urlId, refreshing its RAG content (app-token / B2B variant of ethora-sources-site-reindex). Async — the existing source record is updated in place once indexing finishes. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId or urlId. Related: get urlId from ethora-sources-site-list-v2; ethora-sources-site-reindex-v2-wait blocks until done.

Re-crawl and re-embed a previously crawled URL and block until the server finishes — a single-call, long-timeout variant of ethora-sources-site-reindex-v2 (same refresh effect). Returns { done: true, durationMs, result }. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId or urlId; 504/timeout if it takes longer than timeoutMs (the job may still complete server-side). Related: get urlId from ethora-sources-site-list-v2.

Set the RAG retrieval tags on a crawled website source — replaces the source's tag set with the provided tags array (not additive; pass [] to clear all). Tags let the bot's ragTags narrow retrieval. Auth: app-token mode OR B2B mode with an explicit appId. Errors: 401/403 wrong auth; 404 unknown appId or sourceId. Related: get sourceId from ethora-sources-site-list-v2; doc equivalent is ethora-sources-docs-tags-update-v2.

Report the current Ethora MCP session state: configured API URL, active auth mode, which credentials are present (booleans like hasAppJwt — values never echoed), and the selected appId/agentId. Auth: none required. Errors: effectively none. Related: ethora-doctor for an active connectivity check.

Authenticate as an existing Ethora user with email + password. Stores the user session token in this MCP session and unlocks user-auth tools (ethora-app-list, ethora-files-*, ethora-wallet-*). Auth: user-auth mode (ethora-auth-use-user first) and a configured appJwt. Errors: 401/403 bad credentials; 404 email not registered; 429 per-IP rate limit — retry with backoff.

Register a new Ethora end-user account by email + first/last name. Creates a pending user record and triggers a verification email — the user must click the link before ethora-user-login succeeds. Auth: user-auth mode and a configured appJwt (tells the server which app the user belongs to). Errors: 401 no appJwt; 422 email already registered, invalid names, or invalid appJwt. Related: bulk provisioning uses ethora-users-batch-create-v2.

Provision many Ethora users (1–100) in one asynchronous batch job — the bulk equivalent of ethora-user-register. Enqueues a background job (HTTP 202); the job reports per-user conflicts rather than failing the whole batch. Returns { jobId, statusUrl }. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken). Errors: 401/403 not in B2B mode; 422 usersList validation. Related: track with ethora-wait-users-batch-job-v2.

Fetch the current status and per-user results of a users batch job by jobId (one-shot, no polling). Returns the job object with its state (pending/running/completed/failed) and per-user outcomes. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken) — must match the auth used to create the job. Errors: 401/403 not in B2B mode; 404 unknown jobId. Related: ethora-wait-users-batch-job-v2 for a blocking wait.

Block until a broadcast job reaches a terminal state (completed or failed) or until timeoutMs — read-only polling wrapper around ethora-chats-broadcast-job-v2. Returns { done, state, job }, or { done: false, reason: "timeout" } on timeout. Auth: app-token mode OR B2B mode with an explicit appId — must match the auth used to enqueue the job. Errors: 401/403 wrong auth; 404 unknown jobId.

Block until a users batch job reaches a terminal state (completed or failed) or timeoutMs — read-only polling wrapper around ethora-users-batch-job-v2. Returns { done, state, job }, or { done: false, reason: "timeout" } on timeout. Auth: B2B mode (ethora-auth-use-b2b + a configured b2bToken) — must match the auth used to create the job. Errors: 401/403 not in B2B mode; 404 unknown jobId.

Read the authenticated user's on-chain ERC-20 wallet balance(s). Auth: user-auth (log in first). Errors: 401 not logged in; 503 wallet RPC unreachable — retry with backoff.