MCP server

Ethora

io.github.dappros/ethora-mcp-server

Checked 26 Oct 2026, 08:29 UTC · It answered and asked for a sign-in

Ethora chat platform MCP: apps, users, rooms, AI agents, chat widgets. Hosted or stdio.

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Signs in with your account

Tools

24

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.ethora-mcp-server]
url = "https://mcp.chat.ethora.com/mcp/oauth"

Gemini CLI

{"mcpServers":{"ethora-mcp-server":{"httpUrl":"https://mcp.chat.ethora.com/mcp/oauth"}}}

Cursor

{"mcpServers":{"ethora-mcp-server":{"url":"https://mcp.chat.ethora.com/mcp/oauth"}}}

VS Code

{"servers":{"ethora-mcp-server":{"type":"http","url":"https://mcp.chat.ethora.com/mcp/oauth"}}}

Antigravity

agy mcp add ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"ethora-mcp-server","server_url":"https://mcp.chat.ethora.com/mcp/oauth","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"ethora-mcp-server","server_url":"https://mcp.chat.ethora.com/mcp/oauth"}

Signs in with your account: your agent app opens a sign-in page the first time you use it.

Tools

• ethora-agent-activate ~510 tokens
  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 roo
• ethora-agent-create ~1528 tokens
  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 contr
• ethora-agent-invite ~386 tokens
  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 c
• ethora-agent-list ~449 tokens
  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 ag
• ethora-agent-update ~1243 tokens
  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
• ethora-api-key-create ~215 tokens
  Mint a long-lived, revocable API key for the currently logged-in user. The key is a user token: send it as `Authorization: Bearer <key>` to the hosted MCP endpoint (or set it in the stdio client) to skip `ethora-user-login`. Shown once. Auth: user auth (logged in). Errors: 401 not logged in; 404 on
• ethora-app-create ~277 tokens
  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-crede
• ethora-app-list ~188 tokens
  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
• ethora-app-select ~460 tokens
  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 ac
• ethora-app-update ~551 tokens
  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 - o
• ethora-chat-create ~368 tokens
  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
• ethora-chat-history ~418 tokens
  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. Requ
• ethora-feedback-submit ~628 tokens
  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 sess
• ethora-help ~356 tokens
  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-message-send Sends messages · ~630 tokens
  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 `waitForRep
• ethora-source-doc-upload ~590 tokens
  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. Requires:
• ethora-source-site-crawl-wait Browses the web · ~764 tokens
  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 finis
• ethora-status ~130 tokens
  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. Auth: none required. Errors: effectively no
• ethora-tools-enable ~333 tokens
  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
• ethora-user-login ~417 tokens
  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-mode-set` first) and a configured `appJwt`. Errors: 401/403 bad cr
• ethora-user-register ~518 tokens
  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). Auth: user-auth
• ethora-widget-snippet-get ~767 tokens
  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 an
• fetch ~137 tokens
  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`). Auth: none required. Errors: unknown id.
• search ~216 tokens
  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 Ethor

Browse

• GitHub tools
• Web scraping
• PDF tools
• Email
• Notes and wikis

Related MCP servers

• 4words
  Ephemeral text/file sharing and real-time multi-agent chat rooms for LLM agents and humans.
• Panda Video
  Video hosting: upload, organize and configure videos, analytics, AI subtitles and Shorts.
• Aspicio
  DXF and PDF/X-4 for AI agents: structured facts, PNG renders, an interactive in-chat viewer.
• SRIFT
  Decentralized E2EE P2P file transfer + chat: human to human, human to AI, AI to AI. No accounts.
• Wake Word Training
  Train custom wake words from your agent: estimator, GPU training, benchmarks. Card or crypto.
• iDos Games
  Configure cross-platform and web3 games on iDos Games: live config, tokens, NFTs, AI assets, builds.
• SingChat
  Free live chat and AI support agent. Auto-create a workspace and embed from your AI editor.
• Fluxink Fci
  Convert handwriting into text, LaTeX math, chemistry, or molecular structures.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.dappros/ethora-mcp-server.svg)](https://aptlynx.net/servers/io.github.dappros/ethora-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents