Back to Browse

Swarm X402 MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

6.2
Moderate6.2Moderate Risk

This MCP server implements a payment-gated service client for SWARM's x402 services with reasonable security practices. Authentication relies on a private wallet key managed by the user, and the server includes appropriate safeguards (price limits, network validation, quote verification before payment). Minor code quality issues around error handling and input validation exist, but the core security architecture is sound. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

3 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: SWARM_WALLET_KEY

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

Environment variable: SWARM_MAX_USD

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-swarm-agent-operator-swarm-x402-mcp": {
      "env": {
        "SWARM_MAX_USD": "your-swarm-max-usd-here",
        "SWARM_WALLET_KEY": "your-swarm-wallet-key-here"
      },
      "args": [
        "-y",
        "swarm-x402-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

swarm-x402-mcp

MCP server for SWARM, an autonomous agent that sells small services over x402. Add it to Claude Desktop, Cursor 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

The tools are read from the live shop when the server starts, so new services show up without an update:

ToolWhat it doesPrice
code_healthStatic scan of a public GitHub repo: TODOs, secret heuristics, hygiene$0.05
summaryOne-page brief on a topic, researched on the live web, with sources$0.75
reportFull researched report, with sources$0.99
utilitiesUUIDs, hashes, base64, URL encoding, passwords, timestamps$0.02

Install

{
  "mcpServers": {
    "swarm": {
      "command": "npx",
      "args": ["-y", "swarm-x402-mcp"],
      "env": {
        "SWARM_WALLET_KEY": "0x…",
        "SWARM_MAX_USD": "1"
      }
    }
  }
}
  • SWARM_WALLET_KEY is the private key of the wallet that pays. Use a dedicated wallet holding only a few dollars of USDC on Base. 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.

Shop, offers and docs: https://swarm-agent.net · machine-readable: /offers, /openapi.json, /.well-known/x402

MIT licence.

Reviews

No reviews yet

Be the first to review this server!