Log inSubmit server
Ethora MCP Cli logo

Ethora MCP Cli

Connects AI agents to Ethora for app, chat, user, AI agent, RAG, wallet, and widget operations over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Ethora MCP Cli

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ethora-mcp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@ethora/mcp-server"
      ],
      "env": {
        "ETHORA_API_URL": "YOUR_VALUE_HERE",
        "ETHORA_APP_JWT": "YOUR_VALUE_HERE",
        "ETHORA_B2B_TOKEN": "YOUR_VALUE_HERE",
        "ETHORA_MCP_TRANSPORT": "YOUR_VALUE_HERE",
        "ETHORA_MCP_AUTH_ISSUER": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The ethora-mcp-cli MCP server exposes Ethora chat, messaging, app management, user, AI agent, RAG source, and widget operations as MCP tools. It supports hosted Streamable HTTP, self-hosted HTTP, and a local stdio CLI, with user, app-token, and B2B authentication modes. Use it to create Ethora apps and rooms, configure agents, send and inspect messages, index documents, or generate an embeddable chat widget. The server also includes state inspection, guided help, documentation search, and session-scoped tool-group controls.

Use cases

  • Create Ethora apps and chat rooms
  • Configure and activate AI agents
  • Send messages and inspect chat history
  • Index documents and crawl websites for RAG
  • Generate an embedded Ethora chat widget

Key features

  • Ethora app and room administration
  • AI agent creation, invitation, and activation
  • User authentication and API-key management
  • RAG document upload and website crawling
  • Chat messaging and archived history
  • Hosted HTTP and local stdio transports

Tools24

What Ethora MCP Cli lets your agent do. Expand a tool for its parameters.

Verified live~9.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

What it can do

From the 24 tools this server returned when we ran it; 24 declare their own safety hints.

Can delete or modify data · 1Handles credentials · 17Makes network requests · 23Read-only tools · 23
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age435 days
Maintainers4

Observed 2026-10-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @ethora/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads1.6kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Tools exposed24Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Ethora MCP Cli works

What ethora-mcp-cli MCP server does

The ethora-mcp-cli MCP server connects AI clients and autonomous agents to the Ethora chat and messaging platform. Its tools cover the main lifecycle of an Ethora deployment: creating and updating apps, selecting an app context, creating rooms, adding AI agents, sending messages, and reading archived chat history.

It also supports user registration and login, API-key creation, app credential handling, document uploads, website crawling for RAG sources, and website widget configuration. Agents can create reusable AI personas with prompts and response-gate settings, invite them into rooms, and activate one as the app’s widget bot. Documentation tools provide searchable reference material and task-oriented guidance before an agent makes API calls.

How it works

The server can run as a hosted or self-hosted Streamable HTTP service, or locally through the stdio package command. Hosted clients connect to an Ethora MCP URL and authenticate through OAuth, a personal API-key URL, or a bearer token. A local stdio setup uses environment variables for the Ethora API and bootstrap credentials.

Each MCP session keeps private state such as the selected app, authentication mode, and available credentials. ethora-status reports this state without exposing secret values, while ethora-help recommends next actions based on it. Tool groups are disabled by default beyond the core set; ethora-tools-enable can expose groups such as rooms, agents, sources, users and files, wallet, or B2B operations.

Setup and configuration

For a local process, run the npm package with Node.js 18 or newer and configure ETHORA_API_URL plus ETHORA_APP_JWT. ETHORA_B2B_TOKEN is available for B2B integrations. The HTTP transport is selected with ETHORA_MCP_TRANSPORT=http; hosted and self-hosted deployments use this mode.

A typical first sequence is to inspect state, authenticate or register a user, and list or select an app. ethora-user-register can return a generated password and API key once, allowing a later connection with a bearer credential. On hosted deployments, clients can instead use the OAuth endpoint or a personal connector URL.

Tools and capabilities

  • Manage Ethora apps, rooms, users, API keys, and app credentials.
  • Create, update, list, invite, and activate reusable AI agents.
  • Send messages and retrieve paginated archived chat history.
  • Upload RAG documents and crawl websites while waiting for indexing jobs.
  • Generate an Ethora AI chat-widget script after an agent is activated.
  • Inspect session state, get recommended recipes, search documentation, and fetch full reference entries.
  • Submit product feedback anonymously or from an authenticated session.

Limitations and notes

The ethora-mcp-cli MCP server does not validate an app ID when it is selected; an invalid ID fails on the first app-scoped request. Document indexing is asynchronous, and uploaded files are limited to 50 MB each. Website crawls can exceed the waiting budget even though the server-side job may continue.

Authentication support depends on the operation. App-token and B2B modes handle selected app and source workflows, while several user, room, and agent operations require user authentication or B2B access. Message reply detection and history require message archive support on the Ethora deployment. Treat personal connector URLs and API keys as secrets; keys are shown only when created.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ethora MCP Cli

ethora-mcp-cli is an MCP server that connects AI clients to the Ethora chat and messaging platform. Its main tools manage apps, rooms, users, AI agents, messages, RAG sources, and website widgets. It supports hosted or self-hosted HTTP deployments and a local stdio CLI, with user, app-token, and B2B authentication modes.

Install it locally by running `npx -y @ethora/mcp-server` with Node.js 18 or newer. Set `ETHORA_API_URL` and `ETHORA_APP_JWT` for the stdio process. Alternatively, connect an MCP client to the hosted Ethora endpoint without installing the package.

Yes, ethora-mcp-cli works with Cursor through the hosted MCP URL or a URL-and-headers configuration. The README provides a Cursor installation link and an example using `https://mcp.chat.ethora.com/mcp` with an Authorization bearer token.

Create an agent with `ethora-agent-create`, create or select a room, and invite the agent with `ethora-agent-invite`. To make it answer website visitors, activate it with `ethora-agent-activate`, then generate the embed code with `ethora-widget-snippet-get`.

Yes, `ethora-source-doc-upload` uploads one to five documents to an app’s RAG sources using app-token or B2B authentication. Files are passed as base64 and may be up to 50 MB each. The content becomes queryable after asynchronous indexing completes.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEthora MCP Cli AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ethora-mcp-cli?style=directory)](https://allmcps.com/mcp/ethora-mcp-cli)
HTML Embed
<a href="https://allmcps.com/mcp/ethora-mcp-cli"><img src="https://allmcps.com/api/badge/ethora-mcp-cli?style=directory" alt="Ethora MCP Cli on AllMCPs" /></a>