Tip Md X402 MCP Server

What tipdotmd/tip-md-x402-mcp-server MCP server does

tipdotmd/tip-md-x402-mcp-server MCP server connects AI agents to the tip.md tipping workflow. It exposes MCP tools for sending USDC tips, checking a dedicated tipping wallet, managing wallet funds, looking up recipient wallet support, and checking service health.

The payment flow combines x402 collection with Coinbase Developer Platform disbursement. A user pays from a dedicated tipping wallet; the backend then sends the recipient share and platform share. The documented split is 96% to the recipient and 4% to the platform.

The server supports Base and Solana USDC tipping through the payment tools. A separate manual crypto-tipping tool provides information for agents that already have a wallet and covers Ethereum, Base, and Solana without the x402/CDP flow.

How it works

An MCP client calls a tipping tool with a recipient and amount. For the x402 flow, the agent creates or uses the dedicated payment wallet, collects the payment, and passes the result to the CDP-backed disbursement process. The agent can then report the result to the user.

The repository supports a demo mode intended for testing through an MCP client. Running the process by itself only produces server logs; the tools become useful when a client connects through the supported MCP transport. Local HTTP-stream access uses http://localhost:3000/mcp.

Setup and configuration

For a quick simulation, install dependencies and start the server with NODE_ENV=demo npm start. A production build uses npm install, npm run build, and npm start.

Production configuration requires these values:

• MONGODB_URI for the database connection
• CDP_API_KEY_ID and CDP_API_KEY_SECRET for Coinbase Developer Platform disbursement
• X402_WALLET_PRIVATE_KEY for x402 payment collection

PORT, NODE_ENV, and LOG_LEVEL are also documented configuration values. The example MCP setup for Cursor launches the built Node entry point with demo mode enabled. Claude Desktop can connect through Supergateway, which bridges the server's HTTP stream to stdio.

Tools and capabilities

The tipdotmd/tip-md-x402-mcp-server MCP server lists these tools:

• Send USDC on Base through x402 and CDP.
• Send USDC on Solana through x402.
• Check or create the dedicated tipping wallet and view its balance information.
• Export the tipping wallet private key.
• Withdraw USDC from the tipping wallet to an address.
• Check the recipient's supported cryptocurrencies and wallet types.
• Provide manual crypto-tipping information for Ethereum, Base, and Solana.
• Respond to a health-check request.

The export and withdrawal functions affect wallet security or funds. Private-key export should therefore be treated as a sensitive administrative operation.

Limitations and notes

The provided setup distinguishes demo operation from production integration. Demo mode simulates the flow and does not replace production credentials or platform configuration. Production needs MongoDB, CDP credentials, and the x402 wallet private key.

The README documents Cursor and Claude Desktop configurations, plus an HTTP-stream endpoint for clients that support that transport. ChatGPT is mentioned as an MCP-compatible agent, but no ChatGPT-specific setup is provided. The material also does not state a software license, so licensing should be verified in the repository before deployment.