Skip to content
MCP server

PipRail

Budget-bound x402 payment wallet for AI agents — pays HTTP 402 URLs, capped locally. No…

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

Similar MCP servers

About PipRail

PipRail is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Budget-bound x402 payment wallet for AI agents — pays HTTP 402 URLs, capped locally. No backend.

Install

Run in a terminal

claude mcp add mcp --env PIPRAIL_PRIVATE_KEY='<PIPRAIL_PRIVATE_KEY>' -- npx -y @piprail/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piprail/mcp"
      ],
      "env": {
        "PIPRAIL_PRIVATE_KEY": "<PIPRAIL_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piprail/mcp"
      ],
      "env": {
        "PIPRAIL_PRIVATE_KEY": "<PIPRAIL_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@piprail/mcp"
      ],
      "env": {
        "PIPRAIL_PRIVATE_KEY": "<PIPRAIL_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piprail/mcp"
      ],
      "env": {
        "PIPRAIL_PRIVATE_KEY": "<PIPRAIL_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piprail/mcp"
      ],
      "env": {
        "PIPRAIL_PRIVATE_KEY": "<PIPRAIL_PRIVATE_KEY>"
      }
    }
  }
}

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

Configuration

  • PIPRAIL_PRIVATE_KEYYour wallet's private key/seed for the chosen chain. Optional: omit it to run read-only (discover/quote/register/budget/guide); set it to let the agent pay. Stays on your machine; the spend policy caps every payment.
  • PIPRAIL_CHAINChain to pay on (default: base).
  • PIPRAIL_CHAINSPay across several chains (instead of PIPRAIL_CHAIN): a comma-separated list, e.g. base,polygon,solana. Give each its own PIPRAIL_<CHAIN>_KEY (+ optional PIPRAIL_<CHAIN>_RPC_URL). The agent pays whichever chain a 402 asks for — the first listed that can settle — under one shared budget.
  • PIPRAIL_MAX_AMOUNTMax spend per single payment, in token units (default: 0.10).
  • PIPRAIL_MAX_TOTALLifetime spend cap per token, in token units (default: 10.00).
  • PIPRAIL_MAX_TOTAL_DENOMCross-token GRAND TOTAL: one spend cap per denomination across every stablecoin and chain, e.g. USD:20.00,EUR:5.00. Not a price oracle — sums tokens of the same unit, each counted 1:1. Native coins are excluded.
  • PIPRAIL_MAX_PAYMENTSLifetime cap on the NUMBER of payments, across every chain + token (e.g. 100).
  • PIPRAIL_MAX_PAYMENTS_PER_WINDOWCap on the number of payments within PIPRAIL_WINDOW_SECONDS (a rolling rate limit; set PIPRAIL_WINDOW_SECONDS too).
  • PIPRAIL_WARN_AT_FRACTIONEmit an early-warning event when spend crosses this fraction of any cap, e.g. 0.8 (80%). Needs PIPRAIL_EVENT_LOG to be visible.
  • PIPRAIL_SPEND_LOGPath to a local append-only spend log. When set, the budget (lifetime, grand total, counts) SURVIVES a restart — hydrated from this file. No backend; you own the file.
  • PIPRAIL_EVENT_LOGMirror payment events (settled / declined / budget-threshold) as one-line JSON to 'stderr' or a file path — the operator's notification stream. Default: off.
  • PIPRAIL_TOKENSComma-separated allowed token symbols, plus the alias 'native' for the chain's coin (default: USDC).
  • PIPRAIL_SCHEMESComma-separated payment schemes to settle (default: onchain-proof). Add 'exact' (onchain-proof,exact) to also pay standard x402 servers GASLESS on EVM + Solana (method auto-selected). Add 'upto' to also pay metered x402 servers on EVM (Permit2): sign a MAX, the server settles the actual <= max.

Pricing

Open source

Prices change. Check piprail.com before you buy.

PipRail FAQ

Is PipRail free?

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

How do I add PipRail to Claude Code?

Run this command in your terminal: claude mcp add mcp --env PIPRAIL_PRIVATE_KEY='<PIPRAIL_PRIVATE_KEY>' -- npx -y @piprail/mcp

What are the best alternatives to PipRail?

The closest alternatives to PipRail are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Where this comes from

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

How AIPoweredBot checks servers

Alternatives to PipRail

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 7 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    • 5 tools
    • Remote
    • Open source
    • Legal and government