io.github.llmops-pro/paywall-mcp

Official

by llmops-pro · TypeScript

Lightning-paywall sidecar: wraps any stdio MCP server, requires paid invoices before tool calls.

Wrap MCP servers with a paywall that requires paid invoices before executing tool calls.

Install

Configuration

Environment variables

PAYWALL_UPSTREAM_COMMANDrequired

Command to spawn the upstream MCP server (e.g. npx)

PAYWALL_UPSTREAM_ARGS

JSON array of args for the upstream command

NWC_CONNECTION_STRINGrequiredsecret

NWC connection string of the receiving wallet (receive-only recommended)

PAYWALL_DEFAULT_PRICE_SATS

Default price in sats for tools not in PAYWALL_PRICE_MAP

PAYWALL_PRICE_MAP

JSON map of tool name to price in sats

claude_desktop_config.json

{
  "mcpServers": {
    "paywall-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "paywall-mcp@0.1.2"
      ],
      "env": {
        "PAYWALL_UPSTREAM_COMMAND": "<YOUR_PAYWALL_UPSTREAM_COMMAND>",
        "PAYWALL_UPSTREAM_ARGS": "<YOUR_PAYWALL_UPSTREAM_ARGS>",
        "NWC_CONNECTION_STRING": "<YOUR_NWC_CONNECTION_STRING>",
        "PAYWALL_DEFAULT_PRICE_SATS": "<YOUR_PAYWALL_DEFAULT_PRICE_SATS>",
        "PAYWALL_PRICE_MAP": "<YOUR_PAYWALL_PRICE_MAP>"
      }
    }
  }
}