Back to Browse

Macaroonnetwork MCP Server

Developer ToolsUse Caution4.8Local
Free

Search current public UK company metadata from the official Companies House Public Data API.…

About

Search current public UK company metadata from the official Companies House Public Data API.…

Security Report

4.8
Use Caution4.8High Risk

This MCP server for Macaroon Network demonstrates solid security practices with proper authentication via L402 macaroons, careful credential handling (no hardcoded secrets), and well-designed payment flow controls. The codebase properly isolates wallet operations with safe defaults ("none" mode requiring manual payment). Minor code quality concerns around broad exception handling and subprocess usage in external LND mode do not significantly impact the overall security posture. Permissions (network_http, env_vars, subprocess for optional external LND) are appropriate for the server's stated purpose of accessing a marketplace API and optionally controlling an external LND node. 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 · 14 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.

subprocess_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-companies-house-live-search-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!