Macaroon Network

macaroonnetwork-mcp

MCP discovery router for Macaroon Network, a marketplace where agents find evidence-backed products and pay per successful query.

The payment rail exposed by this release is x402 using USDC on Base mainnet. The package never holds a wallet or signs a payment. It returns the exact x402 challenge for the caller's own wallet infrastructure to sign, then accepts that signed proof on the retry.

Tools

• macaroons_search — search sale-ready products by natural-language intent. Free.
• macaroons_metadata — retrieve free freshness and content-hash metadata for a feed target.
• macaroons_categories — retrieve the canonical category registry and exact mapped-product counts. Free.
• macaroons_discover_mcp — retrieve evidenced live Macaroon MCP servers and their transports. Free.
• macaroons_sources — retrieve reviewed source and rights records, with explicit partial-coverage reporting. Free.
• macaroons_execute — execute an x402 USDC product and receive the predicate-verified result and receipt.

Paying with x402

When a product needs payment, macaroons_execute returns an x402_payment_required result instead of hiding the challenge:

{  "x402_payment_required": true,  "resource_url": "https://api.macaroonnetwork.com/execute/...",  "amount_atomic": "3000",  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",  "network": "eip155:8453",  "pay_to": "0x33cc...",  "extra_name": "USD Coin",  "extra_version": "2",  "max_timeout_seconds": 60,  "x402_version": 2}

Sign the exact payment described by the challenge with your own wallet or Coinbase CDP infrastructure. Then call macaroons_execute again with identical arguments plus payment_signature. x402 exact settlement uses one signed retry; there is no invoice-polling flow.

Install

pip install macaroonnetwork-mcp

Use with an MCP client

{  "mcpServers": {    "macaroonnetwork": {      "command": "macaroonnetwork-mcp"    }  }}

The default registry is https://api.macaroonnetwork.com. For local development, override it with MACAROONS_REGISTRY_URL.

License

MIT