swarm-x402-mcp
A paid MCP server that lets agents call SWARM services over x402 and pay per call in USDC on Base, with no API key or account.
Generate utility outputs: UUIDs, hashes, base64, URL encoding, secure passwords, and timestamp conversions (
utilities, $0.02/call).Scan a public GitHub repo for code health: TODO/FIXME debt, oversized files, secret heuristics, hygiene (
code_health, $0.05/call).Research a topic on the live web into a one-page brief with linked sources (
summary, $0.75/call).Research a topic on the live web into a full Markdown report with linked sources (
report, $0.99/call).Payments require
SWARM_WALLET_KEY; live quotes are checked againstSWARM_MAX_USDbefore paying, and charges settle only on success. Without a key, tools can still list/quote but do not pay.
Integrates with SWARM's x402-paid service shop, enabling agents to call paid tools such as code health scans, live-web summaries and reports, and utility operations, with per-call USDC payments on Base.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@swarm-x402-mcp scan the GitHub repo expressjs/express for code health"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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):
Tool | What you send | What you get | Price |
| a public GitHub repo URL | static scan: TODO/FIXME debt, oversized files, secret heuristics, hygiene | $0.05 |
| a topic | one-page brief, researched on the live web, sources linked | $0.75 |
| a topic | full Markdown report, researched on the live web, sources linked | $0.99 |
| an operation ( | UUIDs, hashes, base64, URL encoding, passwords, timestamps | $0.02 |
| a URL | is it up: HTTP status, final URL after redirects, response time, TLS errors | $0.002 |
| a URL | the readable text of the page (menus, scripts and markup removed) | $0.002 |
Related MCP server: thebuyside-x402-agent
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-mcpCursor (~/.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(default1): the server refuses any call priced above this, before signing anything.
AgentCash: npx agentcash add https://swarm-agent.net
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.
If a call fails
A failed call is a normal tool result with isError: true. Its first line says whether you were charged and whether a
retry is safe, for example charged: no; retry: safe. The tool never retries on its own.
charged: no: nothing was settled (SWARM settles only after the work succeeds). A retry signs a new payment.charged: yes: the receipt carries the transaction hash. Do not pay again; write to contact@swarm-agent.net with it.charged: unknown: the connection broke after a payment was signed. Check your wallet before calling again.
A signed x402 payment can be settled only once (its EIP-3009 nonce), and SWARM's shop also refuses a nonce it has already settled, so the same signed payment can never be charged twice.
Links
Shop and docs: https://swarm-agent.net/mcp/
Live status of the agent and the shop: https://swarm-agent.net/status.html
Machine-readable:
/offers,/openapi.json,/.well-known/x402What we learned selling over x402: x402 seller gotchas
MIT licence.
Available Tools
4 toolscode_healthGitHub repo health scanA
Static scan of a public GitHub repo: TODO/FIXME debt, oversized files, secret heuristics, hygiene. Price: $0.05 per call. Calls SWARM's shop over the network and, with SWARM_WALLET_KEY set, pays in USDC on Base via x402 (the live quote is checked against SWARM_MAX_USD before paying; charged only on success).
Inputs: repo (required).
reportFull web research reportA
A full Markdown report on a topic, researched on the live web at request time, sources linked. Price: $0.99 per call. Calls SWARM's shop over the network and, with SWARM_WALLET_KEY set, pays in USDC on Base via x402 (the live quote is checked against SWARM_MAX_USD before paying; charged only on success).
Inputs: topic (required), context, requirements.
summaryOne-page web research briefA
A one-page brief on a topic, researched on the live web at request time, sources linked. Price: $0.75 per call. Calls SWARM's shop over the network and, with SWARM_WALLET_KEY set, pays in USDC on Base via x402 (the live quote is checked against SWARM_MAX_USD before paying; charged only on success).
Inputs: topic (required), context, requirements.
utilitiesSWARM utilitiesA
UUIDs, hashes, base64, URL encoding, secure passwords and timestamp conversion. Price: $0.02 per call. Calls SWARM's shop over the network and, with SWARM_WALLET_KEY set, pays in USDC on Base via x402 (the live quote is checked against SWARM_MAX_USD before paying; charged only on success).
Inputs: op (required), n, t, algo, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a different service: miscellaneous utilities, repo code scanning, web research brief, and web research report. Summary and report overlap in that both do live web research, but the one-page brief versus full Markdown report distinction is clear from descriptions and pricing.
All names are lowercase noun-style labels, which is consistent enough for this service-catalog style server. The only minor deviation is code_health using an underscore while the others are single words, but this remains predictable and readable.
Four tools is a reasonable, compact surface for a paid service aggregator where each tool maps to a distinct offering. It is slightly thin, but no tool feels redundant or out of scope.
The tools cover four concrete paid operations, but the surface lacks supporting operations for a payment-oriented server, such as checking wallet balance, previewing quotes, or querying transaction status. Agents can perform the main calls, but dead ends around payment state and service discovery remain.
Maintenance
Related MCP Connectors
Pay-per-call APIs via x402 USDC on Base. Hosted MCP: original gateway; stdio: full catalog.
Paid MCP tools behind one endpoint. Agents pay per call in USDC on Base via x402.
Discover and pay for APIs with USDC credits. No wallet, no gas, MCP-native marketplace.
Pay-per-action access to APIs and MCP tools over Lightning L402 and Base USDC x402.
Related MCP Servers
AlicenseNot gradedqualityDmaintenancePay per MCP tool call in USDC on Base. Non-custodial settlement, no admin keys, 30 bps fee.MIT- AlicenseAqualityDmaintenanceThe MCP gateway that lets any AI agent discover and pay metered APIs on Base or Solana — without the user wiring payments themselves.323 npm1Apache 2.0
- AlicenseAqualityFmaintenanceEnables MCP clients to access all endpoints of an x402 gateway by paying real-time microtransactions (USDC on Base) per API call, with automatic tool discovery and spend guardrails.2364 npmMIT

GlianaAI MCP Serverofficial
AlicenseAqualityBmaintenanceEnables pay-per-call access to 90+ generative AI models and utility tools via any MCP client, with no signup or API key, using wallet-based USDC payments on Base, Tempo, or Solana.71,064 npmMIT