Ethora

An MCP server that connects popular MCP clients to the Ethora platform. You can 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).

How to use

You will connect your MCP client to Ethora to perform common actions like authenticating users, managing applications, creating chats for apps, and handling ERC-20 wallet operations. Use the client’s tools to log in, register, create or update applications, manage chats, and query wallet balances. When you see tool names in your client, they correspond to the server’s endpoints for accounts, applications, chats, and wallets. Your workflow typically starts by authenticating, then performing domain tasks such as creating an application, listing your apps, or sending tokens.

Using with Cursor

In Cursor, add a new global MCP server to connect to Ethora. Use the provided MCP server entry pattern to configure the server so that Cursor can reach Ethora tools for auth, apps, chats, and wallets.

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

Using with VS Code MCP extension

In VS Code, open User Settings and add an MCP server entry so the extension can start and communicate with Ethora automatically.

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

Using with Claude Desktop

In Claude Desktop, add the server configuration in the Developer settings. This enables Claude to communicate with Ethora MCP endpoints for login, app management, and wallet actions.

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

Using with Windsurf (Cline)

In Windsurf, run the MCP server locally and configure mcp_config.json to point to Ethora MCP.

npx -y @ethora/mcp-server

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

Quick test

When the server shows as connected in your MCP client, run the available tools to verify functionality. For example, list tools, perform a login with your Ethora credentials, list applications, and check your wallet balance.

Security notes

Do not hardcode API keys in shared configs. Use least-privilege keys and consider allowlists and rate limits on your Ethora backend. Rotate credentials regularly in production.

Development

To run locally, clone the project, install dependencies, build, and start the server.

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

If the client cannot connect, ensure the MCP server starts without errors using npx and that Node.js is version 18 or newer. If authentication fails, verify any needed base URLs or secrets are correctly set in the client environment. If tools don’t appear, restart the MCP client and check server logs for registration messages. Ensure outbound network access from the client to the Ethora host is allowed.

Available tools

login

Login user to the Ethora MCP server and establish an authenticated session.

register

Register a new user on the Ethora MCP server.

create-application

Create a new application under your Ethora account.

update-application

Update properties of an existing application.

delete-application

Remove an application from your Ethora account.

list-applications

List all applications associated with your account.

get-default-rooms

Retrieve the default chat rooms available.

app-get-default-rooms-with-app-id

Get default rooms for a specific application by its ID.

create-app-chat

Create a chat room for a specific application.

delete-app-chat

Delete a chat room for an application.

get-wallet-balance

Query the ERC-20 wallet balance for your account.

wallet-erc20-transfer

Send ERC-20 tokens to another address.