tip.md x402 + CDP MCP Server

🏆 Hackathon Entry: Transform any AI agent into a payment-enabled tipping agent using x402 payment collection with CDP automatic disbursement.

tip.mdis 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 enablingany AI agentto facilitate crypto tipping through the innovative x402 + CDP integration.

For Judges & Evaluators: Experience the x402 + CDP tipping flow instantly:

git clone https://github.com/xR0am/tip-md-x402-mcp-server.git cd tip-md-x402-mcp-server npm install NODE_ENV=demo npm start

⚠️ Important: The server running alone shows logs, but to see thedemo payment functionality, you need to connect it to an MCP client (seeTesting with MCP Clientsbelow).

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
- User: "Check balance"→ Agent:"47.50 USDC available for tipping"
- User asks AI agent: "Tip @username 5 USDC"
- x402 Payment Collection: Agent generates payment request, user pays from dedicated wallet
- CDP Automatic Disbursement: Backend splits payment and sends to recipient + platform
- AI Confirms: "✅ Sent 5 USDC to @username"

User → Dedicated Tipping Wallet → x402 Payment Collection → CDP Agent Wallet → CDP Disburses to Recipient (96%) + Platform (4%)

This MCP server exposes7 toolsthat 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

- 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

- 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)

To see theactual demo payment functionality, you need to connect the MCP server to a compatible client:
- Edit your MCP configuration(~/.cursor/mcp.json):

{ "mcpServers": { "tip-md-demo": { "command": "node", "args": ["dist/mcp-server/src/index.js"], "cwd": "/path/to/tip-md-x402-mcp-server", "env": { "NODE_ENV": "demo" } } } }

Restart Cursorand look for the 🔨 tools icon

- Type: "Tip user johndoe 5 USDC using base blockchain"
- Watch the x402 + CDP simulation in action!
- Install Supergateway(bridges our HTTP transport to stdio):
- Configure Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "tip-md-demo": { "command": "npx", "args": [ "-y", "supergateway", "--httpStream", "http://localhost:3000/mcp", "--outputTransport", "stdio" ] } } }

- Restart Claude Desktopand test with: "Show me available tip.md tools"

For clients supporting HTTP-stream transport:

- Endpoint:http://localhost:3000/mcp(when running locally)
- Transport: HTTP-stream
- Environment: SetNODE_ENV=demofor simulation mode

🛠️ Production Integration (Requires Setup)

For full integration with the tip.md platform:

# Database Connection (Required for production) MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/database # Coinbase Developer Platform (Required for CDP disbursement) CDP_API_KEY_ID=your_cdp_api_key_id CDP_API_KEY_SECRET=your_cdp_api_key_secret # x402 Configuration (Required for payment collection) X402_WALLET_PRIVATE_KEY=your_x402_wallet_private_key # Optional Configuration PORT=3000 NODE_ENV=production LOG_LEVEL=info

- Dedicated Wallets: Each user gets a unique payment wallet
- Protocol Compliance: Full x402 specification implementation

- Smart Splitting: 96% to recipient, 4% to platform
- Instant Settlement: Automated via Coinbase Developer Platform

- Universal Compatibility: Works with any MCP-compatible AI agent
- Structured Responses: Rich JSON responses for seamless integration
- Error Handling: Graceful fallbacks and detailed error messages

Challenge: Coinbase x402 + CDP IntegrationInnovation: Universal AI agent payment enablementDemo Mode:NODE_ENV=demo npm startRepository:https://github.com/xR0am/tip-md-x402-mcp-server
- Universal Agent Integration: Any MCP client becomes payment-enabled
- Complete Payment Flow: x402 collection + CDP disbursement in one solution
- Zero-Setup Demo: Judges can evaluate immediately
- Production-Ready: Already integrated with tip.md platform

- tip.md Platform:https://tip.md
- MCP Protocol:https://modelcontextprotocol.io
- x402 Specification:https://docs.coinbase.com/x402
- Coinbase CDP:https://docs.cdp.coinbase.com

For questions about this hackathon entry:

- Issues: Open a GitHub issue
- Email:support@tip.md
- Demo Problems: Ensure you're testing through an MCP client, not just the server logs

Built for the Coinbase x402 + CDP Hackathon🏆

Give AI agents a Bitcoin wallet with Lightning Network payments

AI agent API marketplace-discover, call, and pay for services with USDC payments. List your own AI services and earn money per call.

x402 payment gateway for AI agents — 12 crypto data tools (price, whale activity, gas, TVL, Fear & Greed, Dune queries) paid per-call in USDC on Stellar or Base. No API keys, no subscriptions.

AI agent commerce: buy gift cards, top up phones, and get travel eSIMs with Bitcoin, Ethereum, Solana, USDC, USDT, Litecoin, Dogecoin, and 15+ cryptos on Base, Polygon, Arbitrum, Tron, and more. No account, no CLI install, no API key — connect via MCP or let your agent pay autonomously with x402.

The infrastructure for AI-driven payments

A live HTTP 402 Lightning tollbooth for AI agents. Sells structured API error intelligence paid per-request over the Lightning Network. No accounts, no OAuth, just pure HTTP 402.

100 x402 micropayment APIs / MCP servers for AI agents. Pay-per-call USDC on Base, no signup. Composable in 6 use-case bundles.

An MCP server enabling AI agents to pay for services using HTTP 402 requests and MCP tools.

MCP server enabling AI agents to make Bitcoin Lightning payments, check balances, access L402 APIs, and manage payment budgets. Supports Strike, OpenNode, NWC, and LND wallets.

Proof-of-Work + Lightning Network authentication for AI agents. Wraps paid MCP tools with L402-signed receipts.

tip.md x402 + CDP

About

Details

Jump to

🛠️ Production Integration (Requires Setup)

💰 x402 + CDP Payment Tools (Hackathon Innovation)

🛠️ Production Integration (Requires Setup)

About

Details

Jump to

🛠️ Production Integration (Requires Setup)

💰 x402 + CDP Payment Tools (Hackathon Innovation)

🛠️ Production Integration (Requires Setup)

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume