MCP server for browsing and paying for evidence-backed data/capabilities on Macaroon Network.
Search sale-ready products by natural-language intent (free).
Retrieve free freshness/content-hash metadata for feed targets.
Get canonical categories, live MCP servers/transports, and reviewed source/rights records (free, per README).
Execute paid marketplace capabilities with predicate verification and receipts, using x402/USDC challenge + signed retry (README) or L402 hold-invoice flow (schema).
Purchase feed-target change-events with spend caps and acceptance predicates (schema).
Override the registry URL with MACAROONS_REGISTRY_URL for local development.
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., "@com.macaroonnetwork/mcp-server search for live Bitcoin price data feeds and show me freshness metadata before I buy one"
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.
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.
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.
Related MCP server: hypawave
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.
pip install macaroonnetwork-mcp{
"mcpServers": {
"macaroonnetwork": {
"command": "macaroonnetwork-mcp"
}
}
}The default registry is https://api.macaroonnetwork.com. For local
development, override it with MACAROONS_REGISTRY_URL.
MIT
Execute a paid marketplace capability by capability_id. Pays via Lightning L402 against a hold invoice — payment only settles if the acceptance predicate passes against the bridge response; bridge errors and predicate failures refund. If no wallet is configured (the default), returns payment_required with a real invoice for you to pay yourself.
Inputs: input (required), capability_id (required), predicate, max_spend_sats, +1 more.
Get free metadata for a feed target before purchasing. Returns freshness and content_hash. No payment required.
Inputs: target_id (required).
Purchase change-events for a feed target. Pays via Lightning L402 against a hold invoice — payment only settles if the acceptance predicate passes against the delivered payload; otherwise it is fully refunded. If no wallet is configured (the default), returns payment_required with a real invoice for you to pay yourself.
Inputs: predicate (required), target_id (required), limit, since, +2 more.
Search Macaroon Network for capabilities matching an intent. Returns ranked listings with price, predicate hash, and freshness. Free, no payment required.
Inputs: intent (required), limit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 4 tools
Each tool targets a distinct stage: search discovers capabilities, metadata inspects a specific feed target pre-purchase, purchase acquires change-events, and execute runs a paid capability. Search and metadata both return freshness, which causes slight overlap, but their inputs and outputs are different enough for an agent to choose correctly.
All tools share the macaroons_ prefix and mostly follow a macaroons_<action> pattern. Three are clear verbs (search, purchase, execute), while metadata is a noun rather than get_metadata, creating a minor inconsistency but not a confusing one.
Four tools is well-scoped for this marketplace-focused server: discover, inspect, acquire, and use. Each tool has a clear purpose and none feel redundant or extraneous.
The core lifecycle for a paid capability marketplace is covered: find capabilities, inspect feed metadata, purchase change-events, and execute capabilities. A minor gap is the lack of a tool to list previously purchased capabilities or check wallet/payment status, but agents can likely work around that using returned capability IDs.
The agent-native marketplace for AI data: search listings and read their price and rights.
Marketplace where AI agents buy/sell skills over Bitcoin Lightning with escrow-backed verification.
Marketplace where AI agents buy/sell skills over Bitcoin Lightning with escrow-backed verification.
Machine-service catalogue, payment hand-off and free market discovery for autonomous AI agents.