# Macaroon Network

> Macaroon Network is a freemium MCP server for ai models and llm tooling. Discover and buy evidence-backed agent products and data with x402 USDC payments. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://macaroonnetwork.com
- **Repository:** https://github.com/kevmoz/macaroonnetwork-mcp
- **MCP Registry name:** com.macaroonnetwork/mcp-server
- **Categories:** AI models and LLM tooling, finance and payments
- **Listing updated:** 2026-11-17

## About

Macaroon Network is a marketplace where agents find services and pay per successful call, and this server is its discovery router. It lets an agent search sale-ready products by intent, list categories, look up live Macaroon MCP servers, review source and rights records, and execute a paid product.

Payment uses x402 with USDC on Base. The package never holds a wallet or signs anything: when a product needs payment, execution returns the exact challenge for the caller's own wallet infrastructure to sign, and the caller retries with the signed proof. Search, metadata, categories, discovery and sources calls are free.

The wider catalogue includes data and science capabilities such as NVD vulnerability search, UK company search, scripture lookup, CFD evidence validation, experiment planning and PINN workflows. The site also sells human products with PayPal checkout. The Python package is MIT licensed and runs over stdio.

## Features

- **Intent-based product search:** Finds sale-ready products from a natural-language goal.
- **x402 payment challenge:** Returns the exact USDC payment request without holding a wallet.
- **Category and source registries:** Lists categories and reviewed source and rights records.
- **Server discovery:** Retrieves live Macaroon MCP servers with transports.
- **Predicate-verified results:** Execution returns a verified result and receipt.

## Good for

- Let an agent find a paid data API for a task
- Run a pay-per-call product with its own wallet
- Browse categories of scientific agent capabilities
- Check sources and rights before using a dataset

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- uvx macaroonnetwork-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "uvx",
      "args": [
        "macaroonnetwork-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "uvx",
      "args": [
        "macaroonnetwork-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "macaroonnetwork-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "uvx",
      "args": [
        "macaroonnetwork-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "uvx",
      "args": [
        "macaroonnetwork-mcp"
      ]
    }
  }
}
```

## Tools

- `macaroons_search`: Search sale-ready products by natural-language intent.
- `macaroons_metadata`: Free freshness and content-hash metadata for a feed target.
- `macaroons_categories`: Canonical category registry with mapped-product counts.
- `macaroons_discover_mcp`: Evidenced live Macaroon MCP servers and transports.
- `macaroons_sources`: Reviewed source and rights records.
- `macaroons_execute`: Execute an x402 USDC product and receive a verified result and receipt.

## FAQ

### How do payments work?

x402 with USDC on Base: the server returns a challenge, your wallet signs it and the call is retried.

### Does the package hold funds?

No. It never holds a wallet or signs a payment.

### Which calls are free?

Search, metadata, categories, MCP discovery and sources are free.

### How do I install it?

pip install macaroonnetwork-mcp and run the macaroonnetwork-mcp command over stdio.

### Is Macaroon Network free?

Macaroon Network has a free plan, with paid plans for more usage or features.

### How do I add Macaroon Network to Claude Code?

Run this command in your terminal: claude mcp add mcp-server -- uvx macaroonnetwork-mcp

### What are the best alternatives to Macaroon Network?

The closest alternatives to Macaroon Network are Claude Code Ultimate Guide, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker and Quantivex Research.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/macaroon-network
