Coinbase Chat MCP

Access cryptocurrency data, market information, and trading insights from Coinbase's public API.

An open-sourceModel Context Protocol (MCP)server and web application for seamless integration with Coinbase's public API. This project enables AI agents, LLMs, and developers to interact with cryptocurrency data, market information, and trading insights through a standardized, secure interface.

Perfect for learning crypto without financial risk!🎓

- Full MCP Compliance- Implements complete Model Context Protocol specification
- 13 Powerful Tools- Real-time prices, historical data, market stats, asset search, technical analysis, and transaction simulation
- 🍺₿ Circular Economy- Complete flow: USD → Crypto → Virtual Beer!
- Smart Suggestions- AI guides you to buy crypto if needed before purchases
- Virtual Wallet & Inventory- Track balances, transactions, and beer collection
- Cursor Integration- Pre-configured for Cursor IDE with.cursor/mcp.json
- Claude Desktop Compatible- Works with any MCP-compatible client
- Secure & Fast- Built-in rate limiting and intelligent caching

- AI-Powered Conversations- GPT-4 integration for intelligent crypto discussions
- Voice Input- Speak your questions with multi-language support via OpenAI Whisper
- Text-to-Speech- AI responses read aloud with natural voices
- Session Persistence- Chat history saved across browser tabs and restarts
- Session Management- Create, switch, and manage multiple chat sessions
- Auto-Titling- Sessions automatically titled from first user message
- Real-time Sync- Live updates when switching between sessions

- Interactive Documentation- Live testing interface for all 8 MCP tools
- Real-time Testing- Execute API calls directly from the browser
- Code Generation- Auto-generated cURL and JavaScript examples
- Copy-to-Clipboard- Easy code sharing and integration
- Comprehensive Coverage- All endpoints documented with parameters and examples

- Beautiful UI- Clean, responsive design with TailwindCSS
- Real-time Data- Live cryptocurrency prices and market updates
- Multiple Pages- Dashboard, Markets, Assets, Analysis, Chat, and API Explorer
- Mobile Friendly- Responsive design works on all devices

git clone https://github.com/your-username/coinbase-chat-mcp.git cd coinbase-chat-mcp

npm install # Install dependencies for all workspaces cd mcp-server && npm install && cd .. cd frontend && npm install && cd .. cd api-server && npm install && cd ..

Configure environment variables (Optional for AI features)

cd frontend # Create .env file with your OpenAI API key for voice features echo "VITE_OPENAI_API_KEY=your_openai_api_key_here" > .env cd ..

# Start API server (port 3002) cd api-server && npm run dev & # Start frontend (port 5173) cd frontend && npm run dev &

The project includes pre-configured Cursor MCP settings:
- Automatic Configuration-.cursor/mcp.jsonis already configured
- Restart Cursor- MCP server will auto-load with 8 tools available
- Test Integration- Try asking: "What's the current Bitcoin price?"

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "coinbase-mcp": { "command": "node", "args": ["/path/to/coinbase-chat-mcp/mcp-server/dist/index.js"], "env": { "COINBASE_API_URL": "https://api.coinbase.com/v2", "LOG_LEVEL": "info" } } } }

- get_spot_price- Current cryptocurrency prices
- get_historical_prices- Historical price data with time ranges
- get_exchange_rates- Fiat currency exchange rates
- search_assets- Find cryptocurrencies and assets
- get_asset_details- Detailed asset information
- get_market_stats- 24-hour market statistics
- get_popular_pairs- Popular trading pairs
- analyze_price_data- Technical analysis (volatility, trends, support/resistance)
- calculate_beer_cost- Convert beer money to crypto amounts
- simulate_btc_purchase- Simulate buying crypto with USD
- buy_virtual_beer🔥 - Buy virtual beer WITH crypto! (Circular economy)
- get_virtual_wallet- View demo wallet balance and stats
- get_transaction_history- View simulated transaction history

🎯Try asking: "Buy me a beer!" → AI will guide you through USD→BTC→Beer! 📖Full docs:DEMO_TRANSACTIONS.md•CIRCULAR_ECONOMY.md

┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Cursor IDE │ │ Web Browser │ │Claude Desktop│ │ (MCP Client)│ │ (React App) │ │ (MCP Client)│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ └────────────────┴────────────────┘ │ ┌────────────────┴────────────────┐ │ │ ▼ ▼ ┌──────────────┐ ┌──────────────────┐ │ MCP Server │ │ API Server │ │ (13 tools) │ │ (REST API) │ └──────┬───────┘ └────────┬─────────┘ │ │ └───────────┬───────────────────┘ │ ┌───────────┴───────────┐ │ │ ▼ ▼ ┌──────────────┐ ┌─────────────────┐ │ Coinbase API │ │ Demo Wallet │ │ (Real Data) │ │ (Simulated) │ └──────────────┘ └─────────────────┘

📖Detailed Architecture: SeeARCHITECTURE.mdfor:

coinbase-chat-mcp/ ├── mcp-server/ # MCP Protocol Server (13 tools) ├── api-server/ # Express REST API Server ├── frontend/ # React + TypeScript Frontend │ ├── src/pages/ # Chat, Wallet, API Explorer │ ├── src/components/ # Reusable UI components │ └── src/services/ # AI, Voice, Chat sessions ├── docs/ # Comprehensive documentation └── .cursor/ # Cursor IDE MCP configuration

# frontend/.env (Optional - for AI chat) VITE_OPENAI_API_KEY=your_openai_api_key_here

To enable the AI-powered chat interface with voice capabilities:
- Get OpenAI API Key: Visit[OpenAI Platform
- Create frontend/.env file:

VITE_OPENAI_API_KEY=sk-your-actual-api-key-here

🎤 Voice Features (Requires OpenAI API Key)

Once configured, you'll have access to:

-

🌐 Multi-Language Voice Input- Speak questions in any language using OpenAI Whisper

- Supports 50+ languages including English, Spanish, French, German, Russian, Chinese, Japanese, and more
- Real-time speech-to-text transcription
- Click the purple microphone button to start recording

🔊 Text-to-Speech Responses- Hear AI responses read aloud

- Click the speaker icon on any assistant message
- Natural-sounding voices powered by OpenAI TTS
- Multiple voice options available

⚡ Fallback Mode- Without OpenAI key, basic Web Speech API provides English-only voice input

…