agentic-pay MCP Server

Name: agentic-pay MCP Server
Author: io.github.ShieldCubed

io.github.ShieldCubed/agentic-pay

Repository Registry

What is the agentic-pay MCP server?

Non-custodial payment engine for AI agents — BTC, ETH, USDT, USDC, XRP, XMR, ZEC.

How to install agentic-pay

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

AGENTIC_PAY_AGENT_ID
Identifier for this agent, used to look up its spend-limit policy in config.json.
AGENTIC_PAY_CONFIG
Absolute path to your config.json (spend limits, API keys, static prices). Defaults to config/config.json in the install directory.
BTC_WIF
secret
WIF-encoded Bitcoin private key for the funding wallet. Only required if using the BTC rail.
ETH_RPC_URL
EVM JSON-RPC endpoint URL. Only required if using the ETH/USDT/USDC rails.
ETH_PRIVATE_KEY
secret
0x-prefixed Ethereum private key for the funding wallet. Only required if using the ETH/USDT/USDC rails.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agentic-pay": {
      "command": "npx",
      "args": [
        "-y",
        "@shieldcubed/agentic-pay"
      ],
      "env": {
        "AGENTIC_PAY_AGENT_ID": "<YOUR_AGENTIC_PAY_AGENT_ID>",
        "AGENTIC_PAY_CONFIG": "<YOUR_AGENTIC_PAY_CONFIG>",
        "BTC_WIF": "<YOUR_BTC_WIF>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "ETH_PRIVATE_KEY": "<YOUR_ETH_PRIVATE_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "agentic-pay": {
      "command": "npx",
      "args": [
        "-y",
        "@shieldcubed/agentic-pay"
      ],
      "env": {
        "AGENTIC_PAY_AGENT_ID": "<YOUR_AGENTIC_PAY_AGENT_ID>",
        "AGENTIC_PAY_CONFIG": "<YOUR_AGENTIC_PAY_CONFIG>",
        "BTC_WIF": "<YOUR_BTC_WIF>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "ETH_PRIVATE_KEY": "<YOUR_ETH_PRIVATE_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agentic-pay": {
      "command": "npx",
      "args": [
        "-y",
        "@shieldcubed/agentic-pay"
      ],
      "env": {
        "AGENTIC_PAY_AGENT_ID": "<YOUR_AGENTIC_PAY_AGENT_ID>",
        "AGENTIC_PAY_CONFIG": "<YOUR_AGENTIC_PAY_CONFIG>",
        "BTC_WIF": "<YOUR_BTC_WIF>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "ETH_PRIVATE_KEY": "<YOUR_ETH_PRIVATE_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "agentic-pay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shieldcubed/agentic-pay"
      ],
      "env": {
        "AGENTIC_PAY_AGENT_ID": "<YOUR_AGENTIC_PAY_AGENT_ID>",
        "AGENTIC_PAY_CONFIG": "<YOUR_AGENTIC_PAY_CONFIG>",
        "BTC_WIF": "<YOUR_BTC_WIF>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "ETH_PRIVATE_KEY": "<YOUR_ETH_PRIVATE_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add agentic-pay --env AGENTIC_PAY_AGENT_ID=<YOUR_AGENTIC_PAY_AGENT_ID> --env AGENTIC_PAY_CONFIG=<YOUR_AGENTIC_PAY_CONFIG> --env BTC_WIF=<YOUR_BTC_WIF> --env ETH_RPC_URL=<YOUR_ETH_RPC_URL> --env ETH_PRIVATE_KEY=<YOUR_ETH_PRIVATE_KEY> -- npx -y @shieldcubed/agentic-pay