{"id":"io.github.dappros/ethora-mcp-server","slug":"io-github-dappros-ethora-mcp-server","title":"Ethora","description":"Ethora chat platform MCP: apps, users, rooms, AI agents, chat widgets. Hosted or stdio.","version":"26.11.1","publisher":{"kind":"github","id":"dappros","label":"@dappros on GitHub","url":"https://github.com/dappros"},"website":"https://ethora.com/ai-sdk/mcp-server/","repository":"https://github.com/dappros/ethora-mcp-server","remotes":[{"type":"streamable-http","url":"https://mcp.chat.ethora.com/mcp/oauth"},{"type":"streamable-http","url":"https://mcp.chat.ethora.com/mcp"}],"packages":[{"registryType":"npm","identifier":"@ethora/mcp-server","version":"26.11.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Full Ethora API URL. Defaults to https://api.chat.ethora.com/v1 if neither ETHORA_API_URL nor ETHORA_BASE_URL is set.","format":"string","name":"ETHORA_API_URL"},{"description":"Base host URL (e.g. https://api.chat.ethora.com). The server appends /v1 automatically. Use ETHORA_API_URL instead if you need a non-/v1 path.","format":"string","name":"ETHORA_BASE_URL"},{"description":"App JWT used for the user-auth bootstrap flow (login/register). Usually starts with 'JWT '. Optional; can also be set at runtime via the ethora-configure tool.","format":"string","isSecret":true,"name":"ETHORA_APP_JWT"},{"description":"B2B server token used for tenant-actor x-custom-token auth (JWT with type=server). Required for B2B / app provisioning flows. Optional; can also be set at runtime.","format":"string","isSecret":true,"name":"ETHORA_B2B_TOKEN"},{"description":"Set to 'true' to expose destructive tools (app deletion, wallet transfers, bulk delete). Disabled by default.","format":"string","name":"ETHORA_MCP_ENABLE_DANGEROUS_TOOLS"}]}],"published":"2026-11-09","updated":"2026-11-09","status":"online","auth":"","latency_ms":934,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"ethora-status","title":"Session Status","description":"Report the current Ethora MCP session state: configured API URL, active auth mode, which credentials are present (booleans like `hasAppJwt` — values never echoed), the selected appId/agentId, and `hosted`/`sessionId` on the hosted (Streamable HTTP) server.\nAuth: none required. Errors: effectively none. Related: `ethora-doctor` for an active connectivity check.","read_only":true},{"name":"ethora-help","title":"Help and Next Steps","description":"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.\nAuth: none required — inspects state, no API calls. Errors: effectively none. Related: pass a recommended recipe id to `ethora-recipe-run`.","read_only":true},{"name":"ethora-app-select","title":"Select App","description":"Session-only: remembers which app later calls refer to. Changes nothing on the server and can be called again at any time to switch. Set the current app context for this session so app-scoped tools can omit their `appId` argument. On the hosted server the selection is remembered for the signed-in account (24 hours), so a client that opens a new session per call keeps it; `ethora-app-create` select","read_only":true},{"name":"ethora-source-site-crawl-wait","title":"Crawl Website Source and Wait","description":"Adds the crawled pages to an agent's knowledge base (the one named by `agentId`, else the app's default agent); existing documents are kept and nothing is deleted. A URL that is already indexed is refused with 409 unless `force: true` re-crawls it. Crawl a website URL and wait for the crawl to finish: enqueues the job, then polls it until it reports `completed` or `failed`. Returns `{ done, status","read_only":false},{"name":"ethora-source-doc-upload","title":"Upload Knowledge Document","description":"Upload documents (1–5; PDF, text, etc.) into an agent's knowledge base (the one named by `agentId`, else the app's default agent) (app-token / B2B variant of `ethora-source-doc-upload-legacy`). Async - content becomes queryable once indexing finishes; files passed as base64, 50MB max each. Pass `tags` to tag every document of the call in the same request (no separate `ethora-source-doc-tags-update","read_only":false},{"name":"ethora-user-login","title":"Log In","description":"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-*`).\nAuth: user-auth mode (`ethora-auth-mode-set` first) and a configured `appJwt`. Errors: 401/403 bad credentials; 404 email not registered; 429 per-IP rate limit — retry with backoff.","read_only":false},{"name":"ethora-user-register","title":"Register Account","description":"Create a new Ethora user account by email + first/last name, then log in and bind the session. A password is generated when omitted and returned once. By default also mints a long-lived API key so an agent can reconnect later with `Authorization: Bearer <key>` (no human step needed).\nAuth: user-auth mode and a configured `appJwt` (on a hosted server this is preset). Errors: 401 no `appJwt`; 422 em","read_only":false},{"name":"ethora-api-key-create","title":"Create API Key","description":"Mint a revocable API key for the signed-in user, to authorise a script, a CI job or another AI client. The key is a user token with the account's full access: send it as `Authorization: Bearer <key>` to the Ethora API or the hosted MCP endpoint (or set it in the stdio client). Shown once; store it somewhere safe and do not repeat it in later messages. On an OAuth connection (Claude.ai, ChatGPT) th","read_only":false},{"name":"ethora-feedback-submit","title":"Send Feedback","description":"Send feedback about Ethora to the Ethora team: something that does not work, behaves differently from what the tool description promised, is missing, or is badly documented. It reaches the team directly, so prefer it over guessing or silently giving up when a tool fails. Recent failures in this session (tool, error code, request id) are attached automatically when `includeRecentErrors` is true, wh","read_only":false},{"name":"ethora-widget-snippet-get","title":"Widget Embed Snippet","description":"Generate the <script> tag that embeds the Ethora AI chat widget (the floating launcher + chat panel that website visitors use) for an app, plus the prerequisites that must hold before it answers. No API call; pure generator using this deployment's hosted widget URL and public API base. The widget answers with the app's ACTIVE bot: for API-created apps run `ethora-agent-create` -> `ethora-agent-inv","read_only":true},{"name":"ethora-app-list","title":"List Apps","description":"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. Credential fields (appSecret, tenantSecret, appToken, passwords) are redacted in the result; call `ethora-app-credentials-reveal { appId, confirm: true }` to reveal an app's appToken.\nAuth: user-auth mode, active session ","read_only":true},{"name":"ethora-app-create","title":"Create App","description":"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`. The returned app has its credential fields redacted; call `ethora-app-credentials-reveal { appId, confirm: true }` when a snippet needs the appToken.\nAuth: user-auth mode, act","read_only":false},{"name":"ethora-app-update","title":"Update App","description":"Overwrites the fields you pass; previous values are not kept and cannot be restored from the API, so confirm changes to the prompt, name or settings with the user first. Update mutable fields on an app the caller owns (displayName, domainName, appTagline, primaryColor, botStatus). Partial update - omitted fields are left unchanged.\nRequires: an `appId` from `ethora-app-list` or `ethora-app-create`","read_only":false},{"name":"ethora-chat-create","title":"Create Chat Room","description":"Create a new chat room (MUC room) inside an app the caller owns. Every room created this way is listed in the app's rooms (`defaultRooms`); `pinned: true` additionally makes new users auto-join it (existing users are not added), `pinned: false` (default) keeps it opt-in. Returns the new room object including its JID.\nRequires: a selected app (`ethora-app-select`) or an explicit `appId`.\nAuth: user","read_only":false},{"name":"ethora-agent-list","title":"List Agents","description":"List AI agents (`GET /v2/agents`): by default your own agents plus the public ones. Pass `appId` to list only the agents homed in that app (`GET /v2/apps/:appId/agents`, which needs you to manage the app; B2B tokens always use this form). Agents belong to your account, not to one app, so the same agent can answer in several of your apps. Public agents (e.g. the platform's Support Agent, sample per","read_only":true},{"name":"ethora-agent-create","title":"Create Agent","description":"Create a reusable AI agent (POST /v2/apps/:appId/agents). Works in user auth mode (the normal hosted mode) or B2B mode; app-token mode is not accepted by the backend. Each agent is a persona - name, avatar, system prompt, LLM config, plus response-gate settings (responseMode, cooldownSec) that control when it speaks in a room. For multi-agent scenarios (two or more personas conversing in one chat)","read_only":false},{"name":"ethora-agent-update","title":"Update Agent","description":"Overwrites the fields you pass; previous values are not kept and cannot be restored from the API, so confirm changes to the prompt, name or settings with the user first. Update a saved AI agent (PUT /v2/agents/:agentId). All fields are optional - only what you pass is updated. Common uses: tune the system `prompt` after a test run, switch `responseMode` to control turn-taking in multi-agent rooms,","read_only":false},{"name":"ethora-agent-activate","title":"Activate Agent for Widget","description":"Make an agent the app's ACTIVE widget bot: sets `App.defaultBotInstanceId` (and `botStatus: on`), which is what `POST /v2/widget/sessions` uses to decide who answers website visitors. Required before an embedded widget can answer on an API-created app. Preconditions: the agent was invited into a room of this app with `ethora-agent-invite` (that creates its bot instance). Works in user auth (app up","read_only":false},{"name":"ethora-agent-invite","title":"Invite Agent to Chat","description":"Invite an Agent into a chat room. Multiple agents can coexist in the same room — call this tool once per agent and they will all appear as members able to converse. Lazily creates a per-App BotInstance (an Ethora user with isBot:true) if one does not already exist for (agent, app). Spawns the XMPP client live; no ai-service restart required. For the full multi-agent recipe see the `ethora-agents-q","read_only":false},{"name":"ethora-message-send","title":"Send Chat Message","description":"Post a message into a chat room of an app (POST /v2/apps/:appId/chats/broadcast targeting one room). The message is attributed to the app's broadcast sender (override the shown name with `senderName`). Use it to seed or test a conversation, e.g. right after `ethora-agent-invite`, and set `waitForReplySec` (up to 60) to wait for an AI agent's answer; replies are returned in `replies`. Identify the ","read_only":false},{"name":"ethora-chat-history","title":"Get Chat History","description":"Read the archived messages of a chat room (GET /v2/apps/:appId/chats/:chatId/messages, newest last). Returns `results` with `from`, `nick`, `body`, `ts` (ms) plus a `nextBefore` cursor for older pages. Identify the room by `roomJid` (`${appId}_${chatId}`) or bare `chatId` plus the selected app.\nRequires: a room in the selected app (`ethora-chat-create`).\nAuth: user auth (default on the hosted serv","read_only":true},{"name":"ethora-tools-enable","title":"Enable More Tools","description":"Session-only: changes which tools this connection lists. Touches no account data. Only the core tools are listed by default. Call this to enable another group for this session; the tool list refreshes automatically (tools/list_changed). On the hosted server the enabled groups are remembered for the signed-in account, so a client that opens a new session per call keeps them. Without `group` it retu","read_only":true},{"name":"search","title":"Search Docs","description":"Search the Ethora documentation and tool reference: auth model (app JWT vs app token vs B2B token vs API keys), hosted-server getting started, chat-component and backend SDK quickstarts, recipes, and a reference entry for every tool with its inputs. Use it for any \"how do I ...\" question about Ethora before guessing; then call `fetch` with a result id to read the full text.\nAuth: none required.","read_only":true},{"name":"fetch","title":"Fetch Doc","description":"Fetch the full text of a documentation section or tool reference entry by the id returned from `search` (e.g. `tool:ethora-app-create`, `doc:auth-map#app-jwt`, `doc:hosted-guide`).\nAuth: none required. Errors: unknown id.","read_only":true}],"server_info":{"name":"Ethora MCP Server","version":"26.11.1"},"category":"communication","tags":["agents","web-search","cloud"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-05-14","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-dappros-ethora-mcp-server/"}