Coinbase Chat MCP

# 🍺₿ Chat Wallet Integration Guide ## Overview The chat interface now supports **interactive wallet transactions**! You can buy crypto, check balances, and view transaction history directly through natural conversation! 🎉 ## 🎯 What You Can Do ### 1. **Buy Crypto with Beer Analogy** 🍺 Ask the AI to buy you "a beer worth of Bitcoin" and watch the magic happen! **Example Conversation:** ``` You: "Buy me a beer worth of Bitcoin" AI: Let me help you with that! First, I'll calculate how much Bitcoin $5 gets you... 🔧 Tool calls executed: 🍺₿ calculate_beer_cost ✅ Success 🍺 $5 = 0.00004531 BTC 🍺₿ simulate_btc_purchase ✅ Transaction Successful! Type: BUY From: 5.00 USD To: 0.00004531 BTC Price: $110,360 ID: tx_1735234567_abc123 ✅ Great! I've purchased 0.00004531 BTC for $5 (one beer's worth!). Your new balance: - USD: $995.00 - BTC: 0.00004531 ``` ### 2. **Buy Specific Amounts** 💰 Purchase any amount of cryptocurrency! **Examples:** ``` "Buy $10 worth of Ethereum" "Purchase $25 of Solana" "Buy $50 worth of Bitcoin for long-term investment" ``` ### 3. **Check Your Wallet** 👛 View your virtual balance at any time! **Examples:** ``` "Show my wallet" "What's my balance?" "How much crypto do I have?" "What's in my virtual wallet?" ``` ### 4. **View Transaction History** 📝 See all your past purchases! **Examples:** ``` "Show my transaction history" "What have I bought?" "Show my last 5 transactions" "Show Bitcoin transactions only" ``` ## 🎨 Enhanced UI Features ### Transaction Display in Chat When you buy crypto through chat, you'll see: ✅ **Green Success Box** with: - Transaction type (BUY/SELL) - Amount converted - Current price - Transaction ID - Timestamp 🍺 **Orange Beer Calculator** showing: - USD amount - Crypto amount - Current price 👛 **Purple Wallet Display** showing: - All currency balances - USD and crypto holdings - Real-time updates ## 🔧 Available Chat Commands ### Quick Actions - **"Buy me a beer worth of Bitcoin"** - Fun $5 BTC purchase - **"Buy $X of [CRYPTO]"** - Purchase any amount - **"Show my wallet"** - View balance - **"Transaction history"** - View purchases - **"How much is a beer in Bitcoin?"** - Just calculate, don't buy ### Supported Cryptocurrencies - Bitcoin (BTC) - Ethereum (ETH) - Solana (SOL) - Cardano (ADA) - Polygon (MATIC) - Avalanche (AVAX) - Litecoin (LTC) - And many more! ## 💡 Example Conversations ### Scenario 1: First Beer Purchase ``` You: Hey! How much Bitcoin is a beer worth? AI: [Calls calculate_beer_cost] At the current BTC price of $110,360, one $5 beer equals approximately 0.00004531 BTC! You: That's cool! Let's buy it! AI: [Calls simulate_btc_purchase] ✅ Transaction Successful! You've purchased 0.00004531 BTC for $5.00 Transaction ID: tx_1735234567_abc123 You: Show me my wallet AI: [Calls get_virtual_wallet] 👛 Your Demo Wallet: 💵 USD: $995.00 🪙 BTC: 0.00004531 📊 Total Transactions: 1 💰 Total Spent: $5.00 ``` ### Scenario 2: Building a Portfolio ``` You: Buy $100 of Bitcoin AI: [Processes purchase] ✅ Purchased 0.000906 BTC for $100.00 You: Also buy $50 of Ethereum AI: [Processes purchase] ✅ Purchased 0.0131 ETH for $50.00 You: What's my portfolio now? AI: [Shows wallet] 👛 Your Portfolio: 💵 USD: $850.00 🪙 BTC: 0.000906 🪙 ETH: 0.0131 📊 Total Spent: $150.00 ``` ### Scenario 3: Comparing Cryptocurrencies ``` You: How much is 3 beers in Bitcoin vs Ethereum? AI: [Calculates both] 🍺 Beer Comparison ($15 total): - Bitcoin: 0.00013593 BTC - Ethereum: 0.00394 ETH Would you like to buy either? ``` ## 🎁 Special Features ### 1. **Visual Transaction Receipts** Every purchase shows: - ✅ Success confirmation - 💰 Amount details - 📊 Current price - 🆔 Transaction ID - 🕐 Timestamp ### 2. **Real-Time Prices** All calculations use **live Coinbase data**! ### 3. **Smart Tool Selection** The AI automatically: - Calculates before purchasing - Shows wallet after transactions - Suggests related actions ### 4. **Color-Coded Tools** - 🟢 Green = Transaction success - 🟠 Orange = Beer calculator - 🟣 Purple = Wallet info - 🔵 Blue = Market data ## 🚀 How It Works (Technical) ### Tool Flow ``` User Query ↓ AI Analysis (GPT-4) ↓ Tool Selection (12 available) ↓ API Call to Backend ↓ DemoWalletClient Execution ↓ Real Coinbase Price Fetch ↓ Transaction Simulation ↓ Enhanced UI Display ↓ AI Response with Details ``` ### Available Tools in Chat 1. **get_spot_price** - Current prices 2. **get_market_stats** - 24h statistics 3. **analyze_price_data** - Technical analysis 4. **get_popular_pairs** - Popular trading pairs 5. **search_assets** - Find cryptocurrencies 6. **get_exchange_rates** - Currency rates 7. **calculate_beer_cost** 🍺 - Beer to crypto 8. **simulate_btc_purchase** 💰 - Buy crypto 9. **get_virtual_wallet** 👛 - Check balance 10. **get_transaction_history** 📝 - View purchases ## 🎮 Try These Now! ### Fun Queries ``` "How many beers equal 1 full Bitcoin?" "Buy me 2 beers worth of Ethereum" "If I stopped buying coffee for a month ($150), how much SOL could I buy?" "Compare the price of a pizza ($20) in BTC vs ETH" ``` ### Portfolio Building ``` "Buy $50 of Bitcoin" "Buy $30 of Ethereum" "Buy $20 of Cardano" "Show my portfolio value" "What's my transaction history?" ``` ### Market Analysis + Trading ``` "What's the current Bitcoin price?" "Analyze Ethereum's volatility" "Buy $100 of the most stable crypto" "Show me what I've bought and their current values" ``` ## 🎨 UI Enhancements ### Chat Message Improvements - **Wallet tool indicator**: 🍺₿ icon on wallet tools - **Colored borders**: Purple for wallet tools - **Expandable details**: Transaction breakdowns - **Balance displays**: Inline wallet balances - **Quick buttons**: New suggested actions ### Suggested Questions Updated to include: - 🍺 "Buy me a beer worth of Bitcoin" - 👛 "What's in my virtual wallet?" - 💰 "Buy $10 worth of Ethereum" - 📝 "Show my transaction history" ## 📊 API Integration ### New Endpoints Used by Chat ```bash GET /api/v1/wallet/calculate-beer-cost?currency=BTC&beerCount=1 POST /api/v1/wallet/purchase GET /api/v1/wallet GET /api/v1/wallet/transactions?limit=10 ``` ### Response Format All wallet tools return structured data that's automatically formatted in the chat UI. ## 🔐 Safety & Education - ✅ **100% Safe** - All transactions are simulated - ✅ **Real Prices** - Uses live Coinbase data - ✅ **Educational** - Learn transaction flows - ✅ **No Risk** - Virtual money only - ✅ **Persistent** - Wallet persists during session - ✅ **Resettable** - Can reset anytime ## 🌟 Pro Tips 1. **Combine Tools**: Ask complex questions that use multiple tools - "Check Bitcoin price, then buy $10 worth" - "Show my wallet, then buy more if I have enough" 2. **Natural Language**: Talk naturally! - "Get me some Bitcoin" works just as well as technical commands 3. **Voice Input**: Use the microphone to speak your requests! - 🎤 "Buy me a beer worth of Bitcoin" 4. **Context Aware**: The AI remembers your conversation - "Buy another one" after buying beer - "Show me what I just bought" ## 🎯 Next Steps ### Want More Features? We can add: - Portfolio performance tracking - Price alerts - Crypto-to-crypto swaps - Export transaction history - Visual charts of holdings - Real Coinbase API integration ## 🚀 Start Using It! 1. **Make sure API server is running** ```bash cd api-server && npm run dev ``` 2. **Open the chat**: `http://localhost:5173/` 3. **Try it**: "Buy me a beer worth of Bitcoin!" 4. **Check wallet**: Navigate to "Virtual Wallet" page or ask in chat! --- **Have fun buying virtual beer worth of Bitcoin!** 🍺₿🎉