Coinbase Commerce

by zhangzhongnan928

362 downloads
Not rated
GitHub

About

Enables cryptocurrency payment processing through Coinbase Commerce API with tools for generating payment links and retrieving transaction details

Details

Author
zhangzhongnan928
Repository
zhangzhongnan928/mcp-coinbase-commerce
Downloads
362
Categories
Design, Developer Tools, AI, API, Frontend, Security, Infrastructure, Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Coinbase Commerce
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /path/to/mcp-coinbase-commerce/dist/index.js
    Environment
    • COINBASE_COMMERCE_API_KEY your_api_key_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

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:

json
{
"mcpServers": {
"coinbase-commerce": {
"command": "node",
"args": ["/path/to/mcp-coinbase-commerce/dist/index.js"],
"env": {
"COINBASE_COMMERCE_API_KEY": "your_api_key_here"
}
}
}
}
```

5. Save the file and restart Claude for Desktop
6. You should now see a hammer icon in the chat interface, indicating available tools

create-charge

Generates a new payment link with the specified parameters: name (string), description (string), amount (string), currency (string), and an optional redirectUrl (string) to redirect after payment completes.

get-charge

Retrieves information about an existing charge using the chargeId (string) parameter.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "coinbase commerce": {
            "env": {
                "COINBASE_COMMERCE_API_KEY": "your_api_key_here"
            },
            "args": [
                "/path/to/mcp-coinbase-commerce/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "COINBASE_COMMERCE_API_KEY": "your_api_key_here"
    },
    "args": [
        "/path/to/mcp-coinbase-commerce/dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "COINBASE_COMMERCE_API_KEY": "your_api_key_here"
    },
    "args": [
        "/path/to/mcp-coinbase-commerce/dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "COINBASE_COMMERCE_API_KEY": "your_api_key_here"
    },
    "args": [
        "/path/to/mcp-coinbase-commerce/dist/index.js"
    ],
    "command": "node"
}

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

5. Save the file and restart Claude for Desktop
6. 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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.