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