Coinbase Commerce

Integrates with
Coinbase Commerce

MCP Coinbase Commerce Server

This is a Model Context Protocol (MCP) server that connects to the Coinbase Commerce API, allowing AI assistants like Claude to generate cryptocurrency payment links.

Features

  • Generate Coinbase Commerce payment links with customizable amount, currency, and description
  • Retrieve information about existing charges
  • Secure API key management
  • Easy integration with Claude and other MCP-compatible AI assistants

Prerequisites

  • Node.js 16.0+
  • A Coinbase Commerce account
  • Coinbase Commerce API key (Get one here)

Setup

  1. Clone this repository:

    git clone https://github.com/zhangzhongnan928/mcp-coinbase-commerce.git
    cd mcp-coinbase-commerce
    
  2. Install dependencies:

    npm install
    
  3. Copy .env.example to .env and add your Coinbase Commerce API key:

    cp .env.example .env
    # Edit .env file with your API key
    
  4. Build the project:

    npm run build
    
  5. Start the server:

    npm start
    

Usage with Claude for Desktop

Once the server is running, you can connect it to Claude for Desktop:

  1. Open Claude for Desktop
  2. Click on the Claude menu → Settings → Developer
  3. Click "Edit Config" to open claude_desktop_config.json
  4. Add the MCP server configuration:
{
  "mcpServers": {
    "coinbase-commerce": {
      "command": "node",
      "args": ["/path/to/mcp-coinbase-commerce/dist/index.js"],
      "env": {
        "COINBASE_COMMERCE_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. Save the file and restart Claude for Desktop
  2. You should now see a hammer icon in the chat interface, indicating available tools

Example Prompts for Claude

Once connected, you can ask Claude to generate payment links:

  • "Can you create a payment link for $10 USD donations to my project?"
  • "Generate a Coinbase Commerce payment link for my coffee shop with a price of $5.50"
  • "Look up the payment status for charge ID 93e23c3e-8220-4e6c-9bc3-ea3548339621"

Claude will use the appropriate tools to fulfill these requests, generating payment links you can share with customers.

API Tools

create-charge

Generates a new payment link with the following parameters:

  • name: Name of the payment/product
  • description: Description of what the payment is for
  • amount: Payment amount (e.g., "10.00")
  • currency: Currency code (e.g., "USD", "EUR", "BTC")
  • redirectUrl (optional): URL to redirect after payment completes

get-charge

Retrieves information about an existing charge using:

  • chargeId: ID of the charge to retrieve

Development

To run the server in development mode:

npm run dev

Testing with MCP Inspector

You can test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT