Labsco
MCP SERVER

Ethora MCP CLI

by dappros

Run an Ethora chat platform from your agent — provision apps and rooms, broadcast messages, and configure the AI bot that answers in them.

Team Chat PlatformsVerified
Summary
The whole Ethora lifecycle, from a first login to unattended tenant provisioning.

Two paths run through the same server: a developer logging in with an email and password to work on their own apps, and a backend token that provisions tenants with no human session at all. The operations that take time — broadcasts, site crawls, user batches — each ship a wait variant, so an agent holds the thread instead of inventing a polling loop. Destructive tools stay out of the tool list until you switch them on.

What it is

A local stdio server for Ethora, an open-source chat and messaging platform with a built-in AI agent framework. It talks to the Ethora API, defaulting to https://api.chat.ethora.com/v1, and covers both the hands-on developer path and server-side tenant provisioning.

What you get
  • Broadcast jobs across an app's chat rooms, with a poller that waits until the job reports completed or failed
  • RAG sources for the bot: crawl a site, reindex a URL, upload documents, then list and tag what got indexed
  • Saved agents you can create, clone, update, and bind as the active bot for an app
  • App provisioning in one call — create the app, mint tokens, provision rooms, configure the bot, choose the runtime LLM
  • App token lifecycle: list metadata, create, rotate (old one revoked, new one returned once), revoke by id
  • Async user batches you can enqueue, poll, or block on until they finish
  • Generators that hand back paste-ready output: an App.tsx snippet for the chat component, .env.example templates, and a B2B bootstrap runbook
  • ethora-help, which reads the current session state and names the next call to make
  • One response envelope on every tool — ok, ts, meta, and either data or an error carrying code, httpStatus, requestId, and a one-line hint
Requirements

Node.js 18.x or higher. Clients launch it over stdio with npx -y @ethora/mcp-server; no global install. ethora-doctor runs with no credentials. Real work needs either ETHORA_APP_JWT for the login and register bootstrap, or ETHORA_B2B_TOKEN for tenant-actor flows; ETHORA_API_URL or ETHORA_BASE_URL points at a stack other than the default. Credentials can also be set for the session with ethora-configure instead of environment variables. App deletion, wallet transfers, and bulk deletes stay hidden until ETHORA_MCP_ENABLE_DANGEROUS_TOOLS is set to true.

Setup effort

One command plus a key — npx -y @ethora/mcp-server, then supply credentials