{"id":30409738,"url":"https://github.com/dappros/ethora-mcp-server","last_synced_at":"2026-01-20T17:03:18.853Z","repository":{"id":308552363,"uuid":"1033234054","full_name":"dappros/ethora-mcp-server","owner":"dappros","description":"Model Context Protocol server for Ethora: login, app \u0026 chat management, and wallet tools (ERC-20) for MCP clients (Cursor, VS Code, Claude).","archived":false,"fork":false,"pushed_at":"2026-01-11T13:16:44.000Z","size":149,"stargazers_count":1,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T15:54:56.613Z","etag":null,"topics":["ai-agents","chat-api","claude","claude-desktop","cline","cursor","erc20","ethora","function-calling","mcp","mcp-server","model-context-protocol","nodejs","npm-package","tool-calling","typescript","vscode","wallet","web3","windsurf"],"latest_commit_sha":null,"homepage":"https://ethora.com/ai-sdk/mcp-server/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dappros.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-06T13:54:32.000Z","updated_at":"2025-10-07T14:42:20.000Z","dependencies_parsed_at":"2025-08-06T15:52:53.861Z","dependency_job_id":"17c15bf0-2421-4cd8-8713-71b3f206e48b","html_url":"https://github.com/dappros/ethora-mcp-server","commit_stats":null,"previous_names":["dappros/ethora-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dappros/ethora-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dappros%2Fethora-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dappros%2Fethora-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dappros%2Fethora-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dappros%2Fethora-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dappros","download_url":"https://codeload.github.com/dappros/ethora-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dappros%2Fethora-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","chat-api","claude","claude-desktop","cline","cursor","erc20","ethora","function-calling","mcp","mcp-server","model-context-protocol","nodejs","npm-package","tool-calling","typescript","vscode","wallet","web3","windsurf"],"created_at":"2025-08-21T22:30:05.163Z","updated_at":"2026-01-20T17:03:18.848Z","avatar_url":"https://github.com/dappros.png","language":"TypeScript","readme":"# Ethora MCP Server (Model Context Protocol)\n\n[![npm](https://img.shields.io/npm/v/@ethora/mcp-server.svg)](https://www.npmjs.com/package/@ethora/mcp-server)\n[![Node](https://img.shields.io/badge/node-%E2%89%A518.x-blue.svg)](#)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)\n\nAn MCP (Model Context Protocol) server that connects popular MCP clients to the **Ethora** platform.  \nUse it from **Cursor**, **VS Code MCP**, **Claude Desktop**, or **Windsurf/Cline** to log in, manage apps and chats, and interact with wallets (ERC-20).\n\n---\n\n## ✨ What you get\n\n- **Auth \u0026 Accounts**\n  - `login` — login user\n  - `register` — register user\n\n- **Applications**\n  - `create-application` — create app\n  - `update-application` — update app\n  - `delete-application` — delete app\n  - `list-applications` — list apps\n\n- **Chat \u0026 Rooms**\n  - `get-default-rooms` — list default rooms\n  - `app-get-default-rooms-with-app-id` — rooms for a given app\n  - `create-app-chat` — create chat for app\n  - `delete-app-chat` — delete chat\n\n- **Wallet**\n  - `get-wallet-balance` — get balance\n  - `wallet-erc20-transfer` — send ERC-20 tokens\n\n\u003e 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.\n\n\n\u003cimg width=\"1670\" height=\"995\" alt=\"settings\" src=\"https://github.com/user-attachments/assets/5a3e98da-5362-4ed2-9080-473510ad2837\" /\u003e\n\u003cimg width=\"1691\" height=\"1011\" alt=\"login\" src=\"https://github.com/user-attachments/assets/c70fc2d7-4686-4619-aaad-0ca966ac2912\" /\u003e\n\n\n## 📦 Install / Run\n\n### Pre-requisites\nBefore you begin, ensure you have the following:\n- Node.js installed on your system (recommended version 18.x or higher).\n\n### Install\n\nThe server is distributed as an npm package and is typically launched by MCP clients via **npx**:\n\n```bash\nnpx -y @ethora/mcp-server\n```\n\nNo global install is required.\n\n---\n\n## 🔐 Configuration (env vars)\n\nThe current implementation has no configuration through environment variables.\n\n---\n\n## 🚀 Using with MCP Clients\n\n### Cursor\n\n1. Open **Cursor → Settings → MCP**\n2. Click **Add new global MCP server**\n3. Add an entry for the GrowthBook MCP, following the pattern below:\n\n```json\n{\n  \"mcpServers\": {\n    \"ethora-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ethora/mcp-server\"]\n    }\n  }\n}\n```\n\n3. Save. You should see **green active** when connected.\n\n\n### VS Code (MCP extension)\n\n1. Open **User Settings (JSON)**\n2. Add an MCP entry:\n\n```json\n \"mcp\": {\n    \"servers\": {\n      \"ethora-mcp-server\": {\n        \"command\": \"npx\",\n        \"args\": [\n          \"-y\", \"@ethora/mcp-server\"\n        ]\n      }\n    }\n  }\n```\n\n3. Save. The server will auto-start on first use.\n\n\n### Claude Desktop\n\n1. **Settings → Developer**\n2. Click **Edit Config**\n3. Open `claude_desktop_config.json`\n4. Add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"ethora-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ethora/mcp-server\"]\n    }\n  }\n}\n```\n\n### Windsurf (Cline)\n\n1. Run:\n   ```bash\n   npx -y @ethora/mcp-server\n   ```\n2. Configure your `mcp_config.json` similarly:\n   ```json\n   {\n     \"mcpServers\": {\n       \"ethora-mcp-server\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@ethora/mcp-server\"]\n       }\n     }\n   }\n   ```\n\n   ---\n\n   ---\n\n## 🧪 Quick test\n\nAfter the server shows as **connected** in your client:\n\n- Run `list tools` (client command) to verify Ethora tools are available.\n- Try a login:\n  ```\n  Use the \"login\" tool with your Ethora credentials.\n  ```\n- List applications:\n  ```\n  Call \"list-applications\" to verify connectivity.\n  ```\n- Check wallet:\n  ```\n  Call \"get-wallet-balance\".\n  ```\n\n---\n\n## 🛡️ Security notes\n\n- **Never** hardcode API keys in shared config. Prefer client-side secret stores.\n- Use **least privilege** keys and consider **allowlists/rate limits** on your Ethora backend.\n- Rotate credentials regularly in production use.\n\n---\n\n## 🧰 Development\n\nClone and run locally:\n\n```bash\ngit clone https://github.com/dappros/ethora-mcp-server.git\ncd ethora-mcp-server\nnpm install\nnpm run build\nnpm start\n```\n\nSuggested scripts (if not present):\n```json\n{\n  \"scripts\": {\n    \"build\": \"tsc -p .\",\n    \"start\": \"node dist/index.js\",\n    \"dev\": \"tsx src/index.ts\"\n  }\n}\n```\n\n---\n\n## ❓ Troubleshooting\n\n- **Client can’t connect**: Ensure `npx @ethora/mcp-server` runs locally without errors. Check Node ≥ 18.\n- **Auth errors**: Verify `ETHORA_BASE_URL` and any required secrets are set in the client’s environment.\n- **Tools missing**: Restart the MCP client and inspect server logs for registration errors.\n- **Network**: Confirm outbound access from the IDE to your Ethora host.\n\n---\n\n## 🔗 Related Repos\n\n- **Ethora Chat Component** — our React chat component used in widgets and stand-alone apps\n  https://github.com/dappros/ethora-chat-component\n- **Ethora WP Plugin** — WordPress integration  \n  https://github.com/dappros/ethora-wp-plugin\n- **RAG Demos** — RAG AI assistant examples  \n  https://github.com/dappros/rag_demos\n\n---\n\n## 📜 License\n\nSee [LICENSE](./LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdappros%2Fethora-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdappros%2Fethora-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdappros%2Fethora-mcp-server/lists"}