macaroonnetwork-mcp 0.1.0__tar.gz

macaroonnetwork_mcp-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+.tmp/
+.mcp.json
+.env
+node_modules/
+*.zip
+!handover/*.zip
+.venv/
+.aider*
+infra/lnd/
+.env.save
+.envcd
+.env.local
+.next/

macaroonnetwork_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: macaroonnetwork-mcp
+Version: 0.1.0
+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
+
+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

macaroonnetwork_mcp-0.1.0/README.md

@@ -0,0 +1,54 @@
+# macaroonnetwork-mcp
+
+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

macaroonnetwork_mcp-0.1.0/macaroonnetwork_mcp/__init__.py

@@ -0,0 +1,6 @@
+"""macaroonnetwork-mcp — discovery-only MCP client for Macaroon Network.
+
+See mcp_server.py's module docstring for what this does and does not do.
+"""
+
+__version__ = "0.1.0"

macaroonnetwork_mcp-0.1.0/macaroonnetwork_mcp/mcp_server.py

@@ -0,0 +1,177 @@
+"""macaroonnetwork-mcp — discovery-only MCP server for Macaroon Network.
+
+Exposes two read-only tools any MCP client can use with zero configuration:
+
+- macaroons_search: semantic search over the live marketplace registry.
+- macaroons_metadata: free metadata for a feed target (freshness, content
+  hash) before deciding whether to buy.
+
+Deliberately does NOT expose macaroons_purchase / macaroons_execute (the
+paid tools). The reference implementation of those in the macaroonnetwork
+repo (packages/buyer/) pays by shelling out to this repo's own regtest
+Lightning dev environment (docker compose exec lnd-buyer lncli payinvoice)
+-- there is no docker-compose.dev.yml or regtest LND node on an external
+user's machine, so those tools would silently fail for anyone who isn't
+running inside that repo's checkout. Shipping them here would mean this
+package's "buy" tools crash for every real external user -- exactly the
+kind of unearned-passing-result this whole project exists to avoid on the
+seller side. Real-wallet payment support (a configurable LND node, or the
+Polygon x402/stablecoin credit rail) is a separate, not-yet-built piece of
+work; this package will grow purchase/execute tools once that exists.
+
+Talks to https://api.macaroonnetwork.com by default -- override with
+MACAROONS_REGISTRY_URL / MACAROONS_FEED_URL for local development against
+this repo's own dev stack.
+"""
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+from typing import Any
+
+import requests
+
+_REGISTRY_URL = os.environ.get("MACAROONS_REGISTRY_URL", "https://api.macaroonnetwork.com")
+_FEED_URL = os.environ.get("MACAROONS_FEED_URL", "https://api.macaroonnetwork.com")
+
+
+def get_tool_definitions() -> list[dict[str, Any]]:
+    return [
+        {
+            "name": "macaroons_search",
+            "description": (
+                "Search Macaroon Network for capabilities matching an intent. "
+                "Returns ranked listings with price, predicate hash, and freshness. "
+                "Free, no payment required."
+            ),
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "intent": {
+                        "type": "string",
+                        "description": (
+                            "Natural language description of what the agent needs. "
+                            "E.g. 'GPU pricing data updated in the last 24 hours'"
+                        ),
+                    },
+                    "limit": {
+                        "type": "integer",
+                        "default": 5,
+                        "maximum": 20,
+                        "description": "Maximum number of results to return",
+                    },
+                },
+                "required": ["intent"],
+            },
+        },
+        {
+            "name": "macaroons_metadata",
+            "description": (
+                "Get free metadata for a feed target before purchasing. Returns "
+                "freshness and content_hash. No payment required."
+            ),
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target_id": {
+                        "type": "string",
+                        "description": "The feed target id (e.g. 'runpod').",
+                    },
+                },
+                "required": ["target_id"],
+            },
+        },
+    ]
+
+
+def _ok(data: Any) -> dict[str, Any]:
+    return {"isError": False, "content": [{"type": "text", "text": json.dumps(data)}]}
+
+
+def _error(message: str) -> dict[str, Any]:
+    return {"isError": True, "content": [{"type": "text", "text": message}]}
+
+
+async def _search(args: dict[str, Any]) -> dict[str, Any]:
+    def _do() -> list[dict[str, Any]]:
+        resp = requests.get(
+            f"{_REGISTRY_URL}/listings/search",
+            params={"intent": args["intent"], "limit": args.get("limit", 5)},
+            timeout=15,
+        )
+        resp.raise_for_status()
+        return resp.json().get("listings", [])
+
+    return _ok(await asyncio.to_thread(_do))
+
+
+async def _metadata(args: dict[str, Any]) -> dict[str, Any]:
+    def _do() -> dict[str, Any]:
+        resp = requests.get(f"{_FEED_URL}/meta", timeout=15)
+        resp.raise_for_status()
+        target_id = args["target_id"]
+        for target in resp.json().get("targets", []):
+            if target["target_id"] == target_id:
+                return target
+        raise ValueError(f"unknown target_id: {target_id}")
+
+    try:
+        result = await asyncio.to_thread(_do)
+    except ValueError as exc:
+        return _error(str(exc))
+    return _ok(result)
+
+
+async def call_tool(name: str, arguments: dict[str, Any]) -> dict[str, Any]:
+    if name == "macaroons_search":
+        return await _search(arguments)
+    if name == "macaroons_metadata":
+        return await _metadata(arguments)
+    return _error(f"unknown tool: {name}")
+
+
+def _build_mcp_server():
+    """Wires get_tool_definitions()/call_tool() into a real mcp.server.Server
+    for stdio use. Imported lazily so offline unit tests (which only need
+    get_tool_definitions()/call_tool()) never require the mcp package."""
+    import mcp.types as types
+    from mcp.server import Server
+    from mcp.server.stdio import stdio_server
+
+    async def on_list_tools(ctx, params):
+        tools = [
+            types.Tool(
+                name=t["name"], description=t["description"], input_schema=t["inputSchema"]
+            )
+            for t in get_tool_definitions()
+        ]
+        return types.ListToolsResult(tools=tools)
+
+    async def on_call_tool(ctx, params):
+        result = await call_tool(params.name, params.arguments or {})
+        content = [types.TextContent(type="text", text=item["text"]) for item in result["content"]]
+        return types.CallToolResult(content=content, is_error=result["isError"])
+
+    server = Server(
+        "macaroon-network",
+        version="0.1.0",
+        on_list_tools=on_list_tools,
+        on_call_tool=on_call_tool,
+    )
+    return server, stdio_server
+
+
+async def _main() -> None:
+    server, stdio_server = _build_mcp_server()
+    async with stdio_server() as (read_stream, write_stream):
+        await server.run(read_stream, write_stream, server.create_initialization_options())
+
+
+def main() -> None:
+    """Console-script entry point (see pyproject.toml [project.scripts])."""
+    asyncio.run(_main())
+
+
+if __name__ == "__main__":
+    main()

macaroonnetwork_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "macaroonnetwork-mcp"
+version = "0.1.0"
+description = "Discovery-only MCP client for Macaroon Network -- search and inspect a live marketplace where AI agents pay per query in Bitcoin over Lightning."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Kevin Smith" }]
+keywords = ["mcp", "model-context-protocol", "agent-commerce", "l402", "lightning", "marketplace"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "requests>=2.31.0",
+]
+
+[project.urls]
+Homepage = "https://macaroonnetwork.com"
+Repository = "https://github.com/kevmoz/macaroonnetwork"
+
+[project.scripts]
+macaroonnetwork-mcp = "macaroonnetwork_mcp.mcp_server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["macaroonnetwork_mcp"]