Coinbase Chat MCP

# 🍺₿ Circular Economy: USD → Crypto → Beer! ## 🎉 The Complete Virtual Economy We've created a **full circular economy simulation** where you can: 1. **Buy Crypto** with USD (simulate_btc_purchase) 2. **Buy Beer** with Crypto (buy_virtual_beer) 3. **Track Everything** in your wallet and inventory! This demonstrates real-world crypto use cases in a fun, educational way! ## 🔄 The Flow ``` Step 1: Start with $1000 USD ↓ Step 2: Buy Bitcoin with USD Example: Buy $5 worth of BTC Result: 0.00004531 BTC ↓ Step 3: Buy Virtual Beer with Bitcoin! Example: Buy 1 beer with BTC Cost: 0.00004531 BTC Result: 🍺 x1 in inventory! ``` ## 🎯 How to Use ### Method 1: Through Chat (Natural Language) **Simple Request:** ``` You: "Buy me a beer" AI: Let me help you! First, let me check if you have Bitcoin... [Calls get_virtual_wallet] ❌ You don't have enough BTC yet! 💡 Suggestion: First buy $5 worth of Bitcoin, then buy the beer! You: "OK, buy $5 of Bitcoin first" AI: [Calls simulate_btc_purchase] ✅ Purchased 0.00004531 BTC for $5.00! You: "Now buy me that beer!" AI: [Calls buy_virtual_beer] 🍺 Beer Purchase Successful! Paid: 0.00004531 BTC Received: 1 🍺 🎉 Total beers in inventory: 1 Remaining BTC: 0.00000000 ``` **Direct Request (If You Have Crypto):** ``` You: "Buy me a beer with Bitcoin" AI: [Checks balance, then buys] 🍺 Beer Purchased Successfully! You paid 0.00004531 BTC for 1 beer Total beers: 1 🎉 Cheers! Enjoy your virtual beer! ``` ### Method 2: Through Cursor IDE (MCP Tools) Ask Cursor AI: ``` "Buy a virtual beer using my Bitcoin" "Purchase 3 beers with Ethereum" "Buy a beer, and if I don't have crypto, get some first" ``` ### Method 3: Through Wallet Page Coming soon: Buy beer button in the UI! ## 🛠️ New MCP Tool: `buy_virtual_beer` ### Description Buy virtual beer using cryptocurrency! Creates a complete circular economy. ### Parameters - `quantity` (optional): Number of beers (default: 1) - `currency` (optional): Crypto to pay with (default: BTC) - `pricePerBeer` (optional): Price per beer in USD (default: 5) ### Returns **Success Response:** ```json { "success": true, "message": "🍺 Beer Purchase Successful!...", "transaction": { "id": "tx_...", "type": "buy", "fromCurrency": "BTC", "toCurrency": "BEER", "fromAmount": 0.00004531, "toAmount": 1, "price": 110360.01, "description": "🍺 Bought 1 virtual beer with BTC" } } ``` **Insufficient Crypto Response:** ```json { "success": false, "needsMoreCrypto": true, "suggestedAmount": 5, "message": "❌ Insufficient BTC balance!\n\nYou need: 0.00004531 BTC\nYou have: 0.00000000 BTC\n\n💡 Suggestion: First buy $5 worth of BTC" } ``` ## 💡 Smart Features ### 1. **Automatic Balance Checking** The system automatically checks if you have enough crypto before purchasing. ### 2. **Helpful Suggestions** If you don't have enough, it tells you exactly how much to buy: ``` "You need 0.00004531 BTC but only have 0.00000000 BTC. 💡 Suggestion: Buy $5 worth of BTC first!" ``` ### 3. **Inventory Tracking** Your wallet now shows: - 💵 USD balance - 🪙 Crypto balances - 🍺 Beer inventory (NEW!) ### 4. **Transaction History** All beer purchases are recorded with: - From: BTC amount spent - To: BEER (quantity) - Price at time of purchase - Description: "🍺 Bought 1 virtual beer with BTC" ## 🎮 Example Scenarios ### Scenario 1: The Happy Path ``` User: "I want to buy a beer with Bitcoin" AI: Checking your BTC balance... [Has 0.00005 BTC] Great! You have enough. Buying 1 beer... ✅ Success! Paid 0.00004531 BTC 🍺 Beers in inventory: 1 Remaining BTC: 0.00000469 ``` ### Scenario 2: Need to Buy Crypto First ``` User: "Buy me a beer" AI: Checking your crypto... [Has 0 BTC] ❌ You need 0.00004531 BTC You have: 0 BTC 💡 First buy $5 worth of Bitcoin! User: "OK do it" AI: [Buys $5 of BTC] ✅ Purchased 0.00004531 BTC User: "Now buy the beer" AI: [Buys beer with BTC] 🍺 Beer purchased! You now have 1 beer! ``` ### Scenario 3: Multi-Step Purchase ``` User: "I want to throw a party. Buy me 5 beers with Bitcoin" AI: Calculating... You need 0.00022655 BTC for 5 beers You have: 0.00005 BTC 💡 You need $20 more of Bitcoin User: "Buy $20 of Bitcoin then buy the 5 beers" AI: [Executes both] ✅ Step 1: Bought 0.00018131 BTC ✅ Step 2: Bought 5 beers 🎉 Party time! You have 5 beers! ``` ## 📊 Supported Currencies for Beer You can buy beer with: - Bitcoin (BTC) - Default - Ethereum (ETH) - Solana (SOL) - Cardano (ADA) - Polygon (MATIC) - Any supported cryptocurrency! ## 🎨 UI Features ### In Chat - **Orange boxes** for beer calculations - **Yellow boxes** for "need more crypto" warnings - **Green boxes** for successful beer purchases - **Purple boxes** for wallet with beer inventory ### In Wallet Page - **Orange card** shows beer count in main balance area - **Transaction list** shows BTC → BEER purchases - **Statistics** track total beers purchased ## 🔧 Technical Implementation ### Database Structure ```typescript interface DemoWallet { balances: { USD: number; BTC: number; // ... other cryptos }; inventory: { beers: number; // Total beer count items: VirtualItem[]; // Detailed purchase history }; transactions: [...]; } ``` ### Transaction Record ```typescript { type: 'buy', fromCurrency: 'BTC', toCurrency: 'BEER', fromAmount: 0.00004531, toAmount: 1, description: '🍺 Bought 1 virtual beer with BTC' } ``` ## 🚀 Advanced Use Cases ### 1. **Price Comparison** ``` "How many beers can I buy with 0.0001 BTC vs 0.01 ETH?" ``` ### 2. **Batch Purchases** ``` "Buy 10 beers with Ethereum" "Stock up on 20 beers using my Solana" ``` ### 3. **Strategic Planning** ``` "If Bitcoin goes up 10%, how many more beers can I afford?" "Calculate beer purchasing power of my portfolio" ``` ### 4. **Full Cycle** ``` "Buy $50 of BTC, then use it all to buy beers, show me how many I get" ``` ## 📈 Educational Value This demonstrates: - **Real crypto utility** - Spending crypto like cash - **Price volatility impact** - Beer costs different BTC amounts as price changes - **Transaction flow** - Understanding crypto payments - **Balance management** - Tracking spending - **Multi-step operations** - Complex workflows ## 🎯 Real-World Analogies This simulates: - **Coffee shops accepting Bitcoin** - **Bars taking crypto payments** - **Merchants using crypto** - **Lightning Network** micro-transactions Just like real crypto adoption! 🌍 ## 🔮 Future Enhancements Potential additions: - [ ] Buy other virtual items (coffee, pizza, etc.) - [ ] Sell items back for crypto - [ ] Trading between users - [ ] Price fluctuation bonuses - [ ] Loyalty rewards in crypto - [ ] NFT receipts for purchases - [ ] Expiring beers (use within time limit) - [ ] Beer quality tiers (premium costs more BTC) ## 🎮 Fun Challenges to Try ### Challenge 1: The Beer Collector ``` Goal: Collect 10 beers in your inventory Strategy: Buy crypto smartly and purchase beers ``` ### Challenge 2: The Efficient Trader ``` Goal: Buy maximum beers with minimum USD spent Strategy: Time your BTC purchases when prices dip ``` ### Challenge 3: The Diversifier ``` Goal: Buy beers using 3 different cryptocurrencies Completion: Have BTC→BEER, ETH→BEER, SOL→BEER transactions ``` ## 📚 API Reference ### Endpoint ``` POST /api/v1/wallet/buy-beer ``` ### Request Body ```json { "quantity": 1, "currency": "BTC", "pricePerBeer": 5 } ``` ### Success Response ```json { "success": true, "data": { /* transaction */ }, "message": "🍺 Beer Purchase Successful!..." } ``` ### Insufficient Crypto Response ```json { "success": false, "needsMoreCrypto": true, "suggestedAmount": 5, "message": "❌ Insufficient BTC..." } ``` ## 🎉 Try It Now! ### In Chat: 1. **Say**: "Buy me a beer" 2. **If needed**: Follow AI's suggestion to buy crypto first 3. **Success**: See your beer in inventory! ### Check Results: - **Chat**: See transaction in tool calls - **Wallet Page**: See beer count in balance cards - **History**: See BTC → BEER transaction --- ## 🌟 This Is Amazing Because: ✅ **Full circular economy** - USD → Crypto → Goods ✅ **Smart error handling** - Suggests buying crypto if needed ✅ **Real-world simulation** - Like actual crypto commerce ✅ **Educational** - Shows how crypto payments work ✅ **Fun & Interactive** - Gamified learning! ✅ **Beautiful UI** - Visual feedback everywhere **You've built a complete crypto commerce simulator! 🚀🍺₿** --- **Go ahead and ask the chat: "Buy me a beer!" and watch the economy work!** 🎉