xr0am/tip-md-x402-mcp-server

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

9 stars 12 forks 品質 57 トレンド 17

🏆 Hackathon: Transform any AI agent into a payment-enabled agent using x402 + CDP. MCP server for instant crypto tipping with automatic disbursement.

概要

: Transform any AI agent into a payment-enabled tipping agent using x402 payment collection with CDP automatic disbursement. 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: - : Ethereum, Base,Solana, and Bitcoin Lightning Network - : Tips go straight to your wallet, no custody - : One button, works everywhere markdown is supported - : Transparent pricing, we only make money if you do - : All transactions processed securely in the browser This MCP server extends tip.md's functionality by enabling to facilitate crypto tipping through the innovative x402 + CDP integration. : Experience the x402 + CDP tipping flow instantly: : The server running alone shows logs, but to see the , you need to connect it to an MCP client (see Testing with MCP Clients below).

README

以下は原文 README の抜粋です。原文を見る。

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.

🌟 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:

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

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”

Architecture: True x402 → CDP Flow

User Payment Flow

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

📋 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

GitHub で README 全文を見る

インストール

npx -y supergateway --httpStream http://localhost:3000/mcp --outputTransport stdio

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "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"
      }
    }
  }
}