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 user
  • register — register user

• Applications

  • create-application — create app
  • update-application — update app
  • delete-application — delete app
  • list-applications — list apps

• Chat & Rooms

  • get-default-rooms — list default rooms
  • app-get-default-rooms-with-app-id — rooms for a given app
  • create-app-chat — create chat for app
  • delete-app-chat — delete chat

• Wallet

  • get-wallet-balance — get balance
  • wallet-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

1. Open Cursor → Settings → MCP
2. Click Add new global MCP server
3. Add an entry for the GrowthBook MCP, following the pattern below:

{
  "mcpServers": {
    "ethora-mcp-server": {
      "command": "npx",
      "args": ["-y", "@ethora/mcp-server"]
    }
  }
}

3. Save. You should see green active when connected.

VS Code (MCP extension)

1. Open User Settings (JSON)
2. Add an MCP entry:

 "mcp": {
    "servers": {
      "ethora-mcp-server": {
        "command": "npx",
        "args": [
          "-y", "@ethora/mcp-server"
        ]
      }
    }
  }

3. Save. The server will auto-start on first use.

Claude Desktop

1. Settings → Developer
2. Click Edit Config
3. Open claude_desktop_config.json
4. Add the following configuration:

{
  "mcpServers": {
    "ethora-mcp-server": {
      "command": "npx",
      "args": ["-y", "@ethora/mcp-server"]
    }
  }
}

Windsurf (Cline)

1. Run:

   npx -y @ethora/mcp-server

2. Configure your mcp_config.json similarly:

   {
     "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-server runs locally without errors. Check Node ≥ 18.
• Auth errors: Verify ETHORA_BASE_URL and 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.