tipdotmd/tip-md-x402-mcp-server

> **🏆 Hackathon Entry**: Transform any AI agent into a payment-enabled tipping agent using x402 payment collection with CDP automatic disbursement.
🌟 About tip.md
**tip.md** is a platform that allows developers to receive cryptocurrency tips directly to their wallets via a simple button embeddable in GitHub READMEs, websites, or any markdown content. It supports:
- **Multiple Blockchains**: Ethereum, Base,Solana, and Bitcoin Lightning Network
- **Direct-to-Wallet Payments**: Tips go straight to your wallet, no custody
- **Simple Integration**: One button, works everywhere markdown is supported
- **4% Platform Fee**: Transparent pricing, we only make money if you do
- **Client-Side Security**: All transactions processed securely in the browser
This MCP server extends tip.md's functionality by enabling **any AI agent** to facilitate crypto tipping through the innovative x402 + CDP integration.
🚀 Quick Demo (No Setup Required)
**For Judges & Evaluators**: Experience the x402 + CDP tipping flow instantly:
**⚠️ Important**: The server running alone shows logs, but to see the **demo payment functionality**, you need to connect it to an MCP client (see Testing with MCP Clients below).
🎯 What This Does
**Core Innovation**: ANY AI agent + this MCP = instant payment-enabled agent
- **x402 Payment Collection**: Users pay from dedicated wallets using the x402 payment protocol (Money IN)
- **CDP Automatic Disbursement**: Backend automatically splits payments (96% recipient, 4% platform) via Coinbase Wallet API (Money OUT)
- **MCP Tool Integration**: Works with Claude, ChatGPT, Cursor, or any MCP-compatible agent
- **True Composability**: Transform existing AI workflows into payment-enabled experiences
🔄 The Complete Flow
1. **User: "Check balance"** → Agent: *"47.50 USDC available for tipping"*
2. **User asks AI agent**: "Tip @username 5 USDC"
3. **x402 Payment Collection**: Agent generates payment request, user pays from dedicated wallet
4. **CDP Automatic Disbursement**: Backend splits payment and sends to recipient + platform
5. **AI Confirms**: "✅ Sent 5 USDC to @username"
Architecture: True x402 → CDP Flow
User Payment Flow
📋 Available MCP Tools
This MCP server exposes **7 tools** that any AI agent can use:
**💰 x402 + CDP Payment Tools (Hackathon Innovation)**
- **mcp_tip_md_tip_on_base**: Send USDC tips on Base using x402 payment protocol with CDP automatic disbursement
- **mcp_tip_md_tip_on_solana**: Send USDC tips on Solana using x402 payment protocol
- **mcp_tip_md_check_tipping_balance**: Check/create your dedicated tipping wallet balance and info
**🔧 Wallet Management Tools**
- **mcp_tip_md_export_tipping_wallet**: Export your tipping wallet private key (security sensitive)
- **mcp_tip_md_withdraw_tipping_funds**: Withdraw USDC from your tipping wallet to any address
**🔍 User & Network Tools**
- **mcp_tip_md_get_user_wallet_types**: Check recipient's supported cryptocurrencies and wallet types
- **mcp_tip_md_crypto_tipping**: Manual crypto tipping information for agents with wallet to instruct (Ethereum, Base, Solana - no x402/CDP flow)
**🏥 System Tools**
- **mcp_tip_md_ping**: Health check endpoint