tip.md

Transforms any AI agent into a crypto tipping agent with x402 collection and CDP automatic disbursement.

javascript

6

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

tip.md x402 + CDP MCP Server enables any AI agent to perform crypto tipping using the x402 payment collection flow with automatic CDP disbursement. It pairs with MCP clients to turn conversational agents into payment-enabled assistants, handling tips securely in the browser and distributing funds to recipients and the platform.

How to use

You can use this MCP server with any MCP-compatible AI agent to enable tipping flows. Start a session with your agent, request a tip, and let the system manage the payment request, user payment, and automatic disbursement. The flow relies on dedicated tipping wallets and the x402 protocol to collect payments, then CDP handles the 96%/4% split to the recipient and platform respectively. You can test tipping tasks with a compatible MCP client to observe the demo flow end-to-end.

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

Clone the repository, install dependencies, and start the demo server.

Run the following commands in order:

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

Production integration notes

For full integration with the tip.md platform, configure production environment variables and start the server in production mode.

Environment variables you will typically configure in production include the database and payment gateway credentials. Examples shown include the MongoDB connection string, CDP API keys, and your x402 wallet private key.

Available tools

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 or create your dedicated tipping wallet balance and info

mcp_tip_md_export_tipping_wallet

Export tipping wallet private key (security sensitive)

mcp_tip_md_withdraw_tipping_funds

Withdraw USDC from tipping wallet to another address

mcp_tip_md_get_user_wallet_types

Check recipient's supported cryptocurrencies and wallet types

mcp_tip_md_crypto_tipping

Manual tipping guidance for agents with wallet support (non x402/CDP flow)

mcp_tip_md_ping

Health check endpoint