# RailFi Payout Plans

> RailFi Payout Plans is a free MCP server for finance and payments. Validate bounded USDC and USDT payout plans and reconcile transfers without custody. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://railfi.xyz/plans
- **Repository:** https://github.com/arults/railfi-mcp
- **MCP Registry name:** xyz.railfi/payout-plans
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

RailFi turns invoice or payout rows into a bounded payout-run draft that the owner approves once in their own wallet. The server only checks and records: it never holds funds or keys and does not execute payments.

Four tools cover the flow. create_payout_plan validates recipients, amounts, total budget and time window and exports an approve-once pack. validate_payout_plan checks a plan without an export. fetch_transfers is a read-only lookup of public USDC and USDT transfers on Polygon, Base, Ethereum and Arbitrum, and reconcile_payouts marks lines paid with a transaction hash or skipped and reports progress.

The endpoint needs no API key or OAuth and is limited to 60 requests per minute per IP. The README states that A2A message/send is not implemented and that RailFi is software only, not a money transmitter, bank or custodian. The web app is in a free beta, and wallet connect and on-chain agent limits are listed as coming next.

## Features

- **Plan validation:** Checks recipients, amounts, budget and time window.
- **Approve-once pack:** Exports a pack the owner approves in their own wallet.
- **Transfer lookup:** Read-only USDC and USDT transfers on four chains.
- **Payout reconciliation:** Marks lines paid by tx hash or skipped and reports progress.
- **Non-custodial:** Never holds funds or keys and does not send payments.

## Good for

- Check a contractor payout batch before approving it
- Cap an agent's payout run by budget and time window
- Reconcile on-chain transfers against a payout list
- Look up recent stablecoin transfers to an address

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http payout-plans https://railfi.xyz/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://railfi.xyz/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "payout-plans": {
      "url": "https://railfi.xyz/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "payout-plans": {
      "type": "http",
      "url": "https://railfi.xyz/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "payout-plans": {
      "serverUrl": "https://railfi.xyz/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "payout-plans": {
      "type": "http",
      "url": "https://railfi.xyz/api/mcp"
    }
  }
}
```

## Tools

- `create_payout_plan`: Validate a plan and export an approve-once pack
- `validate_payout_plan`: Check a plan without creating an export
- `fetch_transfers`: Read-only public USDC/USDT transfer lookup
- `reconcile_payouts`: Mark lines paid or skipped and report progress

## FAQ

### Does RailFi move money?

No. The README says the tools never hold funds or keys and do not execute payments.

### Which chains can it read?

Polygon, Base, Ethereum and Arbitrum for USDC and USDT transfers.

### Is there an API key or rate limit?

No key or OAuth is needed; the limit is 60 requests per minute per IP.

### What does it cost?

The site describes a free beta.

### Is A2A supported?

The agent card exists, but the README says A2A message/send is not implemented.

### Is RailFi Payout Plans free?

Yes. RailFi Payout Plans is free to use.

### How do I add RailFi Payout Plans to Claude Code?

Run this command in your terminal: claude mcp add --transport http payout-plans https://railfi.xyz/api/mcp

### What are the best alternatives to RailFi Payout Plans?

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

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/railfi-payout-plans
