Back to Browse

Macaroonnetwork MCP Server

Developer ToolsUse Caution4.2Local
Free

Search DVSA's real, live UK Vehicle Operator Licensing register -- every goods vehicle and PSV…

About

Search DVSA's real, live UK Vehicle Operator Licensing register -- every goods vehicle and PSV…

Security Report

4.2
Use Caution4.2High Risk

This MCP server implements a Lightning Network payment client for accessing marketplace data with reasonable security practices. Code quality is generally good with proper input validation and exception handling. However, there are moderate concerns around subprocess usage for LND payment execution and potential timing/race conditions in the payment workflow that warrant attention. The server appropriately limits permissions to network access and environment variables, matching its purpose. Supply chain analysis found 8 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue (1 critical, 0 high severity).

7 files analyzed · 16 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

Unverified package source

We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-macaroonnetwork-uk-logistics-operator-risk-check-v1": {
      "args": [
        "macaroonnetwork-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Reviews

No reviews yet

Be the first to review this server!