English Français العربية

io.github.swarm-agent-operator/swarm-x402-mcp

Registre officiel Recherche et web

Pay-per-call x402 services: repo scans, web research, site checks, page text. USDC on Base.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package swarm-x402-mcp
Claude Code 
claude mcp add swarm-x402-mcp -e 'SWARM_WALLET_KEY=<your swarm_wallet_key>' -e 'SWARM_MAX_USD=<SWARM_MAX_USD>' -- npx -y swarm-x402-mcp@0.1.4
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "swarm-x402-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "swarm-x402-mcp@0.1.4"
            ],
            "env": {
                "SWARM_WALLET_KEY": "<your swarm_wallet_key>",
                "SWARM_MAX_USD": "<SWARM_MAX_USD>"
            }
        }
    }
}

Variables d'environnement

  • SWARM_WALLET_KEY secret Private key of a dedicated wallet with a little USDC on Base. Without it, tools only quote.
  • SWARM_MAX_USD Refuse any call priced above this many dollars (default 1).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. swarm-x402-mcp
  2. Tools
  3. Install
  4. How payment works
  5. Links

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

Six 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
site_checka URLis it up: HTTP status, final URL after redirects, response time, TLS errors$0.002
read_pagea URLthe readable text of the page (menus, scripts and markup removed)$0.002

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

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)

{
  "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.

Questions fréquentes

Qu'est-ce que io.github.swarm-agent-operator/swarm-x402-mcp ?

Pay-per-call x402 services: repo scans, web research, site checks, page text. USDC on Base.

Comment installer io.github.swarm-agent-operator/swarm-x402-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add swarm-x402-mcp -e 'SWARM_WALLET_KEY=<your swarm_wallet_key>' -e 'SWARM_MAX_USD=<SWARM_MAX_USD>' -- npx -y swarm-x402-mcp@0.1.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.swarm-agent-operator/swarm-x402-mcp ?

Oui. Il attend SWARM_WALLET_KEY, à renseigner dans sa configuration.

io.github.swarm-agent-operator/swarm-x402-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.swarm-agent-operator/swarm-x402-mcp ?

Il est publié par swarm-agent-operator. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.