swarm-x402-mcp

Name: swarm-x402-mcp
Author: swarm-agent-operator

本地服务

github.com/swarm-agent-operator开发工具01 周前更新

代码仓库

关于 swarm-x402-mcp

swarm-x402-mcp 是供 Agent 调用 SWARM 付费服务的 MCP 服务，涵盖代码库扫描、网络研究、实用工具和网址检查。费用以 Base 上的 USDC 按次支付，并可设置支出上限；仅在服务成功后结算。

主要功能

01GitHub 代码库健康扫描
02基于网络研究的摘要与报告
03编码、哈希和 UUID 工具
04网址状态与可读网页工具
05在 Base 上按次支付 USDC
06单次调用价格上限

适用场景

01检查公开 GitHub 代码库的维护问题
02生成带来源的主题简报或报告
03检查网址状态或提取网页正文

MCP 相关

向 MCP 客户端提供六种付费工具。未配置钱包密钥时可列出工具和报价；配置钱包后可在 Base 上按次支付 USDC。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "swarm-agent-operator-swarm-x402": {
      "command": "npx",
      "args": [
        "-y",
        "swarm-x402-mcp"
      ],
      "env": {
        "SWARM_WALLET_KEY": "<SWARM_WALLET_KEY>",
        "SWARM_MAX_USD": "<SWARM_MAX_USD>"
      }
    }
  }
}

启动命令npx -y swarm-x402-mcp

需要配置的环境变量

SWARM_WALLET_KEY密钥Private key of a dedicated wallet with a little USDC on Base. Without it, tools only quote.

SWARM_MAX_USDRefuse any call priced above this many dollars (default 1).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmswarm-x402-mcp0.1.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
n	integer	否	要生成的数量
t	string\|number	否	要转换的时间戳
op	string	是	操作，例如 uuid、hash、base64、password、timestamp（参见 https://swarm-agent.net/openapi.json）
algo	string	否	哈希算法
text	string	否	输入文本，适用于需要文本输入的操作
length	integer	否	密码长度

详细介绍

swarm-x402-mcp

带付费工具的 MCP 服务：你的 Agent 每次调用时都通过 Base 上的 USDC 付款。无需 API 密钥，无需账户。

适用于 SWARM 的 MCP 服务。SWARM 是一个通过 x402 销售小型服务的自主 Agent。将其添加到 Claude Code、Cursor、Claude Desktop 或任何 MCP 客户端。随后，你的 Agent 就可以调用 SWARM 的服务，并通过 Base 上的 USDC 按次付款。无需账户或 API 密钥，只有在服务交付后才会向你收费。

工具

共六个工具。每个工具都会通过网络调用 SWARM 的商店，并在配置钱包密钥后以 USDC 付款，因此没有只读工具；每个工具都会在 MCP 注释中声明这一点（readOnlyHint: false、openWorldHint: true）：

工具	你提供什么	你会得到什么	价格
`code_health`	一个公开的 GitHub 仓库 URL	静态扫描：TODO/FIXME 技术债、过大的文件、密钥启发式检测、代码整洁度	$0.05
`summary`	一个主题	一页简报，基于实时网络调研并附带来源链接	$0.75
`report`	一个主题	完整的 Markdown 报告，基于实时网络调研并附带来源链接	$0.99
`utilities`	一项操作（`uuid`、`hash`、`base64` 等）	UUID、哈希、Base64、URL 编码、密码、时间戳	$0.02
`site_check`	一个 URL	网站是否在线：HTTP 状态、重定向后的最终 URL、响应时间、TLS 错误	$0.002
`read_page`	一个 URL	页面中可读的文本（已移除菜单、脚本和标记）	$0.002

安装

你需要 Node.js 20 或更高版本。请使用专用钱包，并且只在其中存放少量 Base 上的 USDC，用于设置 SWARM_WALLET_KEY。

Claude Code

claude mcp add --transport stdio swarm --env SWARM_WALLET_KEY=0x… --env SWARM_MAX_USD=1 -- npx -y swarm-x402-mcp

Cursor（~/.cursor/mcp.json）和 Claude Desktop（设置 → 开发者 → 编辑配置）

{
  "mcpServers": {
    "swarm": {
      "command": "npx",
      "args": ["-y", "swarm-x402-mcp"],
      "env": {
        "SWARM_WALLET_KEY": "0x…",
        "SWARM_MAX_USD": "1"
      }
    }
  }
}