@echo-protocol/mcp-server

ECHO Protocol MCP Server - Connect Claude Code to the ECHO ecosystem

Exposes TerroSky AI, mining stats, wallet info, EchoDrive, and more to Claude Desktop via Model Context Protocol.

🚀 Quick Start

1. Install

npm install -g @echo-protocol/mcp-server

2. Get API Key

Create an API key at https://echo-alpha.echo-protocol.org/api-terrosky

3. Configure Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "echo": {
      "command": "npx",
      "args": ["-y", "@echo-protocol/mcp-server"],
      "env": {
        "ECHO_API_KEY": "sk-terro-xxxxxxxxxxxxx",
        "ECHO_WALLET": "0xYourWalletAddress",
        "ECHO_TOOLS": "query_terrosky,get_wallet_info,get_mining_stats"
      }
    }
  }
}

4. Restart Claude Desktop

Close and reopen Claude Desktop. The ECHO tools are now available!

🛠️ Available Tools

| Tool | Description | Example | |------|-------------|---------| | query_terrosky | Query TerroSky AI (nano, junior, pro, ultra) | query_terrosky({ model: "junior", prompt: "Explain blockchain" }) | | get_wallet_info | Get wallet role, rewards, activity | get_wallet_info({ address: "0x..." }) | | get_mining_stats | Mining hashrate, rewards, uptime | get_mining_stats({ address: "0x..." }) | | get_echo_balance | ECHO and MATIC balance | get_echo_balance({ address: "0x..." }) | | upload_to_drive | Upload file to EchoDrive | upload_to_drive({ path: "/docs/file.txt", content: "..." }) | | download_from_drive | Download from EchoDrive | download_from_drive({ path: "/docs/file.txt" }) | | submit_mining_job | Submit mining job | submit_mining_job({ model: "junior", task: "training" }) | | get_vpn_status | EchoVPN connection status | get_vpn_status({ address: "0x..." }) |

💬 Usage in Claude Code

Once configured, you can ask Claude:

"What's my ECHO balance?"
→ Calls get_echo_balance()

"Query TerroSky Junior: What is proof of work?"
→ Calls query_terrosky({ model: "junior", prompt: "What is proof of work?" })

"Show my mining stats"
→ Calls get_mining_stats()

"Upload this code to my EchoDrive"
→ Calls upload_to_drive({ path: "/code/script.py", content: "..." })

Claude will automatically use the appropriate ECHO tools!

🔧 Configuration

Environment Variables

| Variable | Required | Description | Default | |----------|----------|-------------|---------| | ECHO_API_KEY | ✅ Yes | Your ECHO API key (from /api-terrosky) | - | | ECHO_WALLET | ✅ Yes | Your wallet address | - | | ECHO_BASE_URL | No | ECHO API base URL | https://api.echo-protocol.org | | ECHO_TOOLS | No | Comma-separated list of tools to enable | All tools |

Enable Specific Tools

To only enable certain tools:

{
  "env": {
    "ECHO_API_KEY": "sk-terro-xxxxx",
    "ECHO_WALLET": "0x...",
    "ECHO_TOOLS": "query_terrosky,get_wallet_info"
  }
}

Available tool names:

• query_terrosky
• get_wallet_info
• get_mining_stats
• get_echo_balance
• upload_to_drive
• download_from_drive
• submit_mining_job
• get_vpn_status

📦 Development

Clone and Install

git clone https://github.com/echo-protocol/mcp-server.git
cd mcp-server
npm install

Build

npm run build

Run Locally

Create .env file:

ECHO_API_KEY=sk-terro-xxxxxxxxxxxxx
ECHO_WALLET=0xYourWalletAddress
ECHO_TOOLS=query_terrosky,get_wallet_info

Then run:

npm run dev

Test with Claude Desktop

Point Claude Desktop config to your local build:

{
  "mcpServers": {
    "echo-dev": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "ECHO_API_KEY": "sk-terro-xxxxx",
        "ECHO_WALLET": "0x..."
      }
    }
  }
}

🔐 Security

• API keys are never logged or exposed
• All requests use HTTPS
• Keys are validated before each tool execution
• Rate limiting enforced by ECHO API

🌐 Links

• Create API Key: https://echo-alpha.echo-protocol.org/api-terrosky
• Configure MCP: https://echo-alpha.echo-protocol.org/mcp-server
• Documentation: https://docs.echo-protocol.org/mcp
• GitHub: https://github.com/echo-protocol/mcp-server
• Support: https://discord.gg/echo-protocol

📄 License

MIT © ECHO Protocol

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md first.

🐛 Issues

Found a bug? Open an issue

📊 Status

• ✅ TerroSky AI integration
• ✅ Wallet info
• ✅ Mining stats
• ✅ Balance checking
• ✅ EchoDrive operations
• 🚧 VPN status (coming soon)
• 🚧 Real-time notifications (planned)

Made with ❤️ by ECHO Protocol

Connect your AI to the blockchain revolution!