Ethora MCP Server (Model Context Protocol)
An MCP (Model Context Protocol) server that connects popular MCP clients to the Ethora platform.
Use it from Cursor, VS Code MCP, Claude Desktop, or Windsurf/Cline to log in, manage apps and chats, and interact with wallets (ERC-20).
✨ What you get
-
Auth & Accounts
login— login userregister— register user
-
Applications
create-application— create appupdate-application— update appdelete-application— delete applist-applications— list apps
-
Chat & Rooms
get-default-rooms— list default roomsapp-get-default-rooms-with-app-id— rooms for a given appcreate-app-chat— create chat for appdelete-app-chat— delete chat
-
Wallet
get-wallet-balance— get balancewallet-erc20-transfer— send ERC-20 tokens
Tool names above reflect the functional areas exposed by the server. Your exact tool names may vary slightly by version; run the client’s “list tools” to confirm.
📦 Install / Run
Pre-requisites
Before you begin, ensure you have the following:
- Node.js installed on your system (recommended version 18.x or higher).
Install
The server is distributed as an npm package and is typically launched by MCP clients via npx:
npx -y @ethora/mcp-server
No global install is required.
🔐 Configuration (env vars)
The current implementation has no configuration through environment variables.
🚀 Using with MCP Clients
Cursor
- Open Cursor → Settings → MCP
- Click Add new global MCP server
- Add an entry for the GrowthBook MCP, following the pattern below:
{
"mcpServers": {
"ethora-mcp-server": {
"command": "npx",
"args": ["-y", "@ethora/mcp-server"]
}
}
}
- Save. You should see green active when connected.
VS Code (MCP extension)
- Open User Settings (JSON)
- Add an MCP entry:
"mcp": {
"servers": {
"ethora-mcp-server": {
"command": "npx",
"args": [
"-y", "@ethora/mcp-server"
]
}
}
}
- Save. The server will auto-start on first use.
Claude Desktop
- Settings → Developer
- Click Edit Config
- Open
claude_desktop_config.json - Add the following configuration:
{
"mcpServers": {
"ethora-mcp-server": {
"command": "npx",
"args": ["-y", "@ethora/mcp-server"]
}
}
}
Windsurf (Cline)
-
Run:
npx -y @ethora/mcp-server -
Configure your
mcp_config.jsonsimilarly:{ "mcpServers": { "ethora-mcp-server": { "command": "npx", "args": ["-y", "@ethora/mcp-server"] } } }
🧪 Quick test
After the server shows as connected in your client:
- Run
list tools(client command) to verify Ethora tools are available. - Try a login:
Use the "login" tool with your Ethora credentials. - List applications:
Call "list-applications" to verify connectivity. - Check wallet:
Call "get-wallet-balance".
🛡️ Security notes
- Never hardcode API keys in shared config. Prefer client-side secret stores.
- Use least privilege keys and consider allowlists/rate limits on your Ethora backend.
- Rotate credentials regularly in production use.
🧰 Development
Clone and run locally:
git clone https://github.com/dappros/ethora-mcp-server.git
cd ethora-mcp-server
npm install
npm run build
npm start
Suggested scripts (if not present):
{
"scripts": {
"build": "tsc -p .",
"start": "node dist/index.js",
"dev": "tsx src/index.ts"
}
}
❓ Troubleshooting
- Client can’t connect: Ensure
npx @ethora/mcp-serverruns locally without errors. Check Node ≥ 18. - Auth errors: Verify
ETHORA_BASE_URLand any required secrets are set in the client’s environment. - Tools missing: Restart the MCP client and inspect server logs for registration errors.
- Network: Confirm outbound access from the IDE to your Ethora host.
🔗 Related Repos
- Ethora Chat Component — our React chat component used in widgets and stand-alone apps https://github.com/dappros/ethora-chat-component
- Ethora WP Plugin — WordPress integration
https://github.com/dappros/ethora-wp-plugin - RAG Demos — RAG AI assistant examples
https://github.com/dappros/rag_demos
📜 License
See LICENSE.