Skip to content
MCP server

Paywall MCP

Lightning-paywall sidecar: wraps any stdio MCP server, requires paid invoices before…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
5 days ago

About Paywall MCP

Paywall MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add paywall-mcp --env PAYWALL_UPSTREAM_COMMAND='<PAYWALL_UPSTREAM_COMMAND>' --env NWC_CONNECTION_STRING='<NWC_CONNECTION_STRING>' -- npx -y paywall-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "paywall-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "paywall-mcp"
      ],
      "env": {
        "PAYWALL_UPSTREAM_COMMAND": "<PAYWALL_UPSTREAM_COMMAND>",
        "NWC_CONNECTION_STRING": "<NWC_CONNECTION_STRING>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "paywall-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "paywall-mcp"
      ],
      "env": {
        "PAYWALL_UPSTREAM_COMMAND": "<PAYWALL_UPSTREAM_COMMAND>",
        "NWC_CONNECTION_STRING": "<NWC_CONNECTION_STRING>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "paywall-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "paywall-mcp"
      ],
      "env": {
        "PAYWALL_UPSTREAM_COMMAND": "<PAYWALL_UPSTREAM_COMMAND>",
        "NWC_CONNECTION_STRING": "<NWC_CONNECTION_STRING>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "paywall-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "paywall-mcp"
      ],
      "env": {
        "PAYWALL_UPSTREAM_COMMAND": "<PAYWALL_UPSTREAM_COMMAND>",
        "NWC_CONNECTION_STRING": "<NWC_CONNECTION_STRING>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "paywall-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "paywall-mcp"
      ],
      "env": {
        "PAYWALL_UPSTREAM_COMMAND": "<PAYWALL_UPSTREAM_COMMAND>",
        "NWC_CONNECTION_STRING": "<NWC_CONNECTION_STRING>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PAYWALL_UPSTREAM_COMMANDCommand to spawn the upstream MCP server (e.g. npx)Required
  • PAYWALL_UPSTREAM_ARGSJSON array of args for the upstream command
  • NWC_CONNECTION_STRINGNWC connection string of the receiving wallet (receive-only recommended)Required
  • PAYWALL_DEFAULT_PRICE_SATSDefault price in sats for tools not in PAYWALL_PRICE_MAP
  • PAYWALL_PRICE_MAPJSON map of tool name to price in sats

Pricing

Open source

Paywall MCP FAQ

Is Paywall MCP free?

Yes. Paywall MCP is open source, so you can use and self-host it for free.

How do I add Paywall MCP to Claude Code?

Run this command in your terminal: claude mcp add paywall-mcp --env PAYWALL_UPSTREAM_COMMAND='<PAYWALL_UPSTREAM_COMMAND>' --env NWC_CONNECTION_STRING='<NWC_CONNECTION_STRING>' -- npx -y paywall-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers