Open-source MCP server enables AI agents to handle L402 payments via Lightning Network

What this tool does

This is an open-source MCP (Model Context Protocol) server that allows AI agents like Claude to interact with APIs that require payment via the L402 protocol. When an agent encounters an HTTP 402 "Payment Required" response, this tool handles the Lightning Network transaction automatically.

How it works

The MCP plugin intercepts HTTP 402 rejections from gated APIs. It reads the BOLT11 invoice included in the response, pays the required satoshis (fractions of Bitcoin) via the Lightning Network, obtains the cryptographic receipt, and then retrieves the data to bring it into the chat session.

The tool addresses a specific limitation in agent workflows: agents can't use credit cards to pay for API access or hire other agents for specialized tasks. This creates what the developer calls "financial rails for the Machine-to-Machine economy."

Technical implementation

The server is built as a Python MCP plugin using FastMCP. The GitHub repository includes a local dummy-agent that developers can spin up to test the functionality without spending actual cryptocurrency. This allows you to observe how Claude handles 402 rejections in a local environment.

The developer specifically mentions this is useful for agent swarms where Agent A might need to pull data from a gated API or hire Agent B for specialized tasks.