Payments MCP 是一款 MCP 服务器及配套钱包应用，将钱包、入口和通过 x402 支付整合为一个代理商务解决方案。

它使人工智能代理能够自主发现并支付服务，无需API密钥、复杂的助记词或人工干预。

阅读相关文档

快速启动

1） 安装支付-mcp：

2） 选择你的MCP客户端：

安装过程中，系统会提示您选择正在配置的MCP客户端：

• Claude - Claude 桌面应用程序
• Claude Code - Claude Code CLI
• Codex - OpenAI Codex CLI
• Gemini - 谷歌 Gemini CLI
• 其他 - 其他兼容MCP的工具

3） 自动配置（可选）：

安装程序支持自动配置以兼容MCP客户端。

安装过程中会提示您，或者您可以：

4） 手动配置（如有需要）：

如果跳过自动配置，会显示详细的安装说明。

示例配置：

用途

命令

选项

• --client, -c ：指定MCP客户端进行配置（claude、claude-code、codex、gemini、其他）

@coinbase/payments-mcp

Payments MCP is an MCP server & companion wallet app that combines wallets, onramps, and payments via x402 into a single solution for agentic commerce.

It enables AI agents to autonomously discover and pay for services without API keys, complex seed phrases, or manual intervention.

Read the documentation

Quick Start

1) Install payments-mcp:

npx @coinbase/payments-mcp

2) Select your MCP client:

During installation, you’ll be prompted to choose which MCP client you’re configuring:

• Claude - Claude Desktop application
• Claude Code - Claude Code CLI
• Codex - OpenAI Codex CLI
• Gemini - Google Gemini CLI
• Other - Other MCP-compatible tools

3) Automatic Configuration (Optional):

The installer supports automatic configuration for compatible MCP clients.

You’ll be prompted during installation, or you can:

# Automatically configure without prompting
npx @coinbase/payments-mcp --client claude --auto-config

# Skip automatic configuration
npx @coinbase/payments-mcp --client claude --no-auto-config

4) Manual Configuration (If Needed):

If you skip automatic configuration, detailed setup instructions will be displayed.

Example Configuration:

{
  "mcpServers": {
    "payments-mcp": {
      "command": "node",
      "args": ["/Users/your-home-dir/.payments-mcp/bundle.js"]
    }
  }
}

Usage

Commands

# Default installation (same as 'install')
npx @coinbase/payments-mcp

# Explicit install command
npx @coinbase/payments-mcp install

# Force reinstallation (even if up to date)
npx @coinbase/payments-mcp install --force

# Check installation status
npx @coinbase/payments-mcp status

# Uninstall payments-mcp
npx @coinbase/payments-mcp uninstall

# Enable verbose logging for any command
npx @coinbase/payments-mcp install --verbose

Options

• --client, -c : Specify MCP client to configure (claude, claude-code, codex, gemini, other)
• --auto-config: Automatically configure the MCP client without prompting (for supported clients)
• --no-auto-config: Skip automatic configuration prompt
• --verbose, -v: Enable detailed logging output
• --force, -f: Force reinstallation even if already up to date
• --help, -h: Show help information

Supported MCP Clients

File Locations

• Installation Directory: ~/.payments-mcp/
• Logs: Displayed in terminal (use --verbose for detailed logs)

Troubleshooting

Common Issues

“Command not found” Error