Metadata-Version: 2.4
Name: macaroonnetwork-mcp
Version: 0.1.2
Summary: Discovery-only MCP client for Macaroon Network -- search and inspect a live marketplace where AI agents pay per query in Bitcoin over Lightning.
Project-URL: Homepage, https://macaroonnetwork.com
Project-URL: Repository, https://github.com/kevmoz/macaroonnetwork
Author: Kevin Smith
License-Expression: MIT
Keywords: agent-commerce,l402,lightning,marketplace,mcp,model-context-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# macaroonnetwork-mcp

<!-- mcp-name: com.macaroonnetwork/mcp-server -->

Discovery-only MCP client for [Macaroon Network](https://macaroonnetwork.com) —
a marketplace where AI agents discover, pay for (Bitcoin/Lightning via L402),
and buy live data.

## What this does

Two tools, both free, no payment or configuration required:

- **`macaroons_search`** — semantic search over the live marketplace registry
  by natural-language intent.
- **`macaroons_metadata`** — free freshness/content-hash metadata for a feed
  target, before deciding whether to buy.

## What this does *not* do (yet)

This package does not expose buying tools (`macaroons_purchase` /
`macaroons_execute`). The reference buyer implementation in the
[macaroonnetwork repo](https://github.com/kevmoz/macaroonnetwork) pays via a
regtest Lightning node that's part of that repo's own dev environment —
there's no way to make that work correctly for an arbitrary external
installation yet. Real-wallet payment support (a configurable Lightning node,
or the Polygon stablecoin credit rail) is planned; this package will grow
purchase tools once that exists. Shipping non-functional buy tools now would
mean they silently fail for every real user, which is exactly the kind of
thing this project's L402/predicate machinery exists to prevent on the seller
side — no reason to reintroduce it here.

## Install

```bash
pip install macaroonnetwork-mcp
```

## Use with an MCP client

```json
{
  "mcpServers": {
    "macaroonnetwork": {
      "command": "macaroonnetwork-mcp"
    }
  }
}
```

Talks to `https://api.macaroonnetwork.com` by default. Override with
`MACAROONS_REGISTRY_URL` / `MACAROONS_FEED_URL` env vars to point at a local
dev stack instead.

## License

MIT
