MCP server: One MCP server.

SWARM X402

@swarm-agent-operatorMCP server · External

Pay-per-call x402 services from SWARM: repo scans, web research. USDC on Base.

v0.1.2MITJavaScript
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

Not assessed yet.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npmswarm-x402-mcpv0.1.2

Run

npx -y swarm-x402-mcp

MCP client config

{
  "mcpServers": {
    "swarm-x402": {
      "command": "npx",
      "args": [
        "-y",
        "swarm-x402-mcp"
      ]
    }
  }
}
README2 min read

swarm-x402-mcp

MCP server with paid tools: your agent pays per call in USDC on Base. No API key, no account.

MCP server for SWARM, an autonomous agent that sells small services over x402. Add it to Claude Code, Cursor, Claude Desktop or any MCP client. Your agent can then call SWARM's services and pay per call in USDC on Base. You need no account and no API key, and you are charged only when the service delivers.

Tools

Four tools. Each one calls SWARM's shop over the network and, with a wallet key, pays in USDC, so none is read-only; every tool declares this in its MCP annotations (readOnlyHint: false, openWorldHint: true):

ToolWhat you sendWhat you getPrice
code_healtha public GitHub repo URLstatic scan: TODO/FIXME debt, oversized files, secret heuristics, hygiene$0.05
summarya topicone-page brief, researched on the live web, sources linked$0.75
reporta topicfull Markdown report, researched on the live web, sources linked$0.99
utilitiesan operation (uuid, hash, base64, …)UUIDs, hashes, base64, URL encoding, passwords, timestamps$0.02

Install

You need Node.js 20 or newer. Use a dedicated wallet holding only a few dollars of USDC on Base for SWARM_WALLET_KEY.

Claude Code

bash
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) and Claude Desktop (Settings → Developer → Edit Config)

json
{
  "mcpServers": {
    "swarm": {
      "command": "npx",
      "args": ["-y", "swarm-x402-mcp"],
      "env": {
        "SWARM_WALLET_KEY": "0x…",
        "SWARM_MAX_USD": "1"
      }
    }
  }
}
  • SWARM_WALLET_KEY: the private key of the wallet that pays. Without it, the tools still list and quote; they explain the price and don't pay.
  • SWARM_MAX_USD (default 1): the server refuses any call priced above this, before signing anything.

How payment works

Each call first reads SWARM's 402 quote without paying. It checks that the network is Base mainnet and that the price is under your limit. Then it pays with the official x402 client (@x402/fetch). SWARM verifies the payment, does the work, and settles only if the work succeeded.

MIT licence.