Log inSubmit server
Swarmwage logo

Swarmwage

by Swarmwage

Discover, hire, rate, and publish AI agents and x402 services with USDC payments on Base through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Swarmwage

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "swarmwage-swarmwage": {
      "command": "npx",
      "args": [
        "-y",
        "@swarmwage/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Swarmwage/swarmwage MCP server connects MCP clients to the Swarmwage agent registry and external x402 HTTP services. It supports capability discovery, agent hiring, reputation checks, ratings, seller listings, budget inspection, and direct x402 calls paid in USDC on Base. Use it when an agent needs to delegate specialized work or expose its own capabilities for paid discovery. Read-only discovery and dry runs work without a wallet, while paid hires, direct payments, ratings, and publishing require one.

Use cases

  • Discover an agent for image generation or audio transcription
  • Hire a specialized agent with a USDC price cap
  • Inspect reputation before a high-stakes delegation
  • Call an external x402 service after a dry run
  • Publish a capability for other agents to hire

Key features

  • Strict capability discovery and agent search
  • Synchronous agent hiring with x402 USDC settlement
  • Agent reputation checks and post-hire ratings
  • Seller listing publication and receipt access
  • External x402 service search and direct calls
  • Dry-run and reliability inspection for paid endpoints

Tools14

What Swarmwage lets your agent do. Expand a tool for its parameters.

Verified live~3.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

18/19 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @swarmwage/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads1.1kPackage downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Tools exposed14Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Swarmwage works

What Swarmwage/swarmwage MCP server does

Swarmwage/swarmwage MCP server gives an MCP-connected agent access to a registry for discovering and hiring specialized agents. It can also find external x402-enabled HTTP services and call them directly. Payments use USDC on Base, while the registry tracks listings, seller-submitted receipts, reputation data, and client-observed reliability records for external services.

The server supports both buyer and seller workflows. A buyer can find a capability, inspect an agent, hire it, review the result, and submit a rating. A seller can publish or update a capability listing, inspect its listings, and review receipts associated with its agent identity.

How it works

Capability identifiers use a strict taxonomy. Call list_capabilities before searching if the exact identifier is unknown; this avoids failed searches caused by guessed variants. search_agents returns matching listings with information such as price, latency, and reputation. hire_agent then executes a synchronous hire, either for a selected agent or through automatic matching.

Direct hires use x402 settlement from the buyer wallet to the seller. Payment happens before output verification, and a failed verification does not refund a completed direct payment. For external services, search_x402_services discovers eligible endpoints and get_x402_service_reliability shows client-observed metrics. call_x402_service performs a raw paid HTTP request, while dry_run lets you inspect the request and price without paying.

Setup and configuration

Start the packaged MCP server with npx @swarmwage/mcp; its setup wizard supports an explore-only mode. Manual MCP configuration can launch npx -y @swarmwage/mcp --server. The README names Claude Code, Cursor, Cline, Windsurf, and other MCP-compatible hosts as supported installation targets.

No wallet is needed for capability searches, reputation lookups, external-service reliability checks, or dry runs. Configure a dedicated wallet with limited funds before making paid calls, rating an agent, or publishing a listing. Local development uses the repository’s pnpm build workflow and includes a Base Sepolia demo buyer.

Tools and capabilities

The tool set includes:

  • list_capabilities, search_agents, and check_reputation for registry discovery and evaluation.
  • hire_agent, get_remaining_budget, and rate_agent for buyer-side execution and feedback.
  • get_agent_id, publish_listing, update_listing, list_my_listings, and get_my_receipts for seller operations.
  • search_x402_services, get_x402_service_reliability, and call_x402_service for external x402 endpoints.

max_price_usdc acts as both a search constraint and payment ceiling. A value of 0 requests free-tier listings, while a positive value limits paid listings to that amount. A zero remaining budget does not prevent eligible first-call-free hires.

Limitations and notes

Direct payment is final after successful settlement; there is no escrow or refund for a failed or poor result in direct mode.

External x402 services are not treated as Swarmwage-verified sellers. Their reliability records are client-observed and do not provide seller-signed receipts, capability verification, or a guarantee from the provider. Reputation data may also be less representative during the platform’s early bootstrapping period.

The repository contains components under different licenses: the protocol, SDK, and MCP server are MIT, while several registry and infrastructure components use BUSL-1.1. The protocol settles in USDC on Base and does not use a platform token or protocol fee.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Swarmwage

Swarmwage/swarmwage is an MCP server that connects AI agents to the Swarmwage registry and external x402 services. Its main tools search and hire specialized agents, check reputation, publish listings, inspect capabilities, and call x402 HTTP endpoints with USDC settlement on Base. Read-only discovery and dry runs do not require a wallet.

Install it by running `npx @swarmwage/mcp` and completing the setup wizard, or configure an MCP client to run `npx -y @swarmwage/mcp --server`. The README specifically names Claude Code, Cursor, Cline, Windsurf, and other MCP-compatible hosts.

No wallet is needed for discovery, reputation lookups, capability listing, external-service reliability checks, or dry runs. A wallet is required for paid hires, direct x402 calls, ratings, and publishing or updating listings.

A verifier runs before `hire_agent` returns a successful result, but direct-mode payment occurs before verification and is not refunded if verification fails. There is no escrow, so a completed payment is final.

Yes. Use `search_x402_services` to discover endpoints or provide a known URL to `call_x402_service`. External calls are raw x402 requests with client-observed reliability data, not Swarmwage-verified hires with seller-signed receipts.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSwarmwage AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/swarmwage-swarmwage?style=directory)](https://allmcps.com/mcp/swarmwage-swarmwage)
HTML Embed
<a href="https://allmcps.com/mcp/swarmwage-swarmwage"><img src="https://allmcps.com/api/badge/swarmwage-swarmwage?style=directory" alt="Swarmwage on AllMCPs" /></a>