ethora

Ethora MCP Server exposes a set of MCP tools to interact with the Ethora platform, including authentication (login, register), application management (create, update, delete, list), chat and rooms (default rooms, app-specific chats, create/delete chats), and wallet operations (get balance, transfer ERC-20 tokens). You can run the server via MCP clients that support MCP tooling, such as Cursor, VS Code MCP, Claude Desktop, or Windsurf/Cline. The server is consumed by clients through standard MCP tool commands (e.g., login, list-applications, get-wallet-balance), once the server is registered in the client configuration. The README examples show how to configure the server in common clients using npx to start the MCP server, and how to invoke tools like list-applications or get-wallet-balance after a successful connection.

Prerequisites:

• Node.js 18.x or higher installed on your system
• npm (comes with Node.js)

Install / Run (from npm package):

1. Run the MCP server directly via npx (no global install required):

npx -y @ethora/mcp-server

2. The server will start and listen for MCP client connections. You can also integrate into clients using the same command pattern shown in the examples below.

If you prefer to clone and run locally (development):

1. Clone the repository and install dependencies:

git clone https://github.com/dappros/ethora-mcp-server.git
cd ethora-mcp-server
npm install

2. Build the project (if using TypeScript):

npm run build

3. Start the server:

npm start

Suggested scripts (if not present):

• build: tsc -p .
• start: node dist/index.js
• dev: tsx src/index.ts

Notes and guidance:

• The current configuration does not require environment variables for operation, per the README. If your deployment environment requires secrets (e.g., Ethora backend keys), keep them in the client configuration or a secure secret store, not in shared config.
• When integrating with MCP clients, ensure the client is configured to point to the ethora-mcp-server via the mcpServers entry (as shown in the examples).
• If tools appear missing or the client cannot connect, restart the MCP client and verify Node.js v18+ is in use on the host. Check server logs for registration or connection errors.
• Security: follow least-privilege principles for any API keys or secrets used by the Ethora backend, and consider rate limiting or allowlisting as appropriate.
• The tool names reflect core capabilities (auth, applications, chat, wallet). Client tooling may slightly vary by version; list tools in the client to confirm exact names.