x402 MCP Server

铋--x402 MCP服务器

人工智能代理的一次性付费API，由Bismuth（x402 API网络）提供支持。一个npm安装，在Base上自动进行USDC小额支付。

工具

2.0.0中的新功能

三个功能扩展和一个新工具：

• 浅层场地爬行 新 x402_crawl_site 工具：BFS从种子URL抓取最多15个页面
• 电子邮件CC/BCC/附件 — x402_send_email 现在接受cc、bcc和base64文件附件
• DOCX转PDF — x402_convert_file 现在支持类型：“docx”进行docx文档转换

快速启动-自由模式

无需钱包或私钥。将服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"]
    }
  }
}

自由模式限制：

• 截图仅限于example.com、example.org和httpbin.org
• PDF提取仅限于前3页
• 情绪返回具有真实市场结构的模拟数据
• 电子邮件返回假邮件ID（无法投递）
• 刮擦返回夹具数据（无实时刮擦）
• 文件转换返回夹具数据（无实时转换）
• 网络搜索返回固定结果（无实时搜索）
• 转录返回固定转录（无实时转录）
• 站点爬网返回夹具数据（无实时爬网）

快速入门--付费模式

需要一个由USDC资助的基础钱包。

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

永远不要提交你的私钥。将其存储在您的系统环境或本地 .env shell加载的文件。

您需要在Base网络上使用USDC。Base是一个以太坊L2，交易费用低。看 完整钱包设置指南 详细说明。

MCP客户端配置

省略 env 完全免费模式下的块。

克劳德桌面版

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

克劳德代码

claude mcp add --transport stdio x402 -- npx -y x402-mcp-server

然后设置 X402_PRIVATE_KEY 在您的环境中。

光标

配置文件： ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

帆板运动

配置文件： ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

运作原理

1. 你的AI代理调用一个工具（例如。， x402_screenshot)
2. MCP服务器向API发出HTTP请求
3. API以 402 Payment Required
4. x402-fetch 在Base上自动签署USDC付款并重试
5. API返回结果

付款流程由以下人员处理 x402-fetch --你的代理人永远不需要直接管理交易。

许可证

麻省理工学院