Skip to content
MCP server

RevRule by Payload

Read revenue-split graphs, review payout evidence and dry-run events, with no writes

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, self-hosted, API
Runs
Locally
Version
1.1.0
Listing updated
2 days ago

About RevRule by Payload

RevRule by Payload is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Contracts that split revenue between several parties are easy to get wrong and hard to audit. This local server gives an agent a safe window onto RevRule, Payload's entitlement engine: it can inspect a revenue graph, list the payout evidence recorded against it, and simulate an incoming revenue event to see what the rules would produce. Simulation has no side effects, so nothing is recorded and no payout is prepared. Version 1 deliberately has no write tools.

Payout evidence links each verified payout back to the original ledger entry, including the transaction hash, log index, block data and authorizing signature. RevRule itself calculates entitlements across splits, royalties, recoupment and waterfalls, and it never holds or moves funds; your payment system does that.

The server runs over stdio on Node.js with no dependencies, installed as an MCPB bundle or from source, and calls the live Payload rail with your own API key. If no key is set, it still starts and each tool call returns a clear error.

Install

Run in a terminal

claude mcp add revrule-mcp -- npx -y https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "revrule-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "revrule-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "revrule-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "revrule-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "revrule-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

revrule_get_graph
Fetch one of your revenue entitlement graphs by id, with participants, rules and ledger wiring. Read-only.
revrule_list_payout_evidence
List payout evidence recorded for a graph, linked to the original entitlement ledger entries.
revrule_simulate_event
Dry-run a revenue event against a graph's rules with no side effects.

What it does

Graph lookup
Fetch a revenue entitlement graph by id, with its participants, rules and ledger wiring.
Payout evidence
List verified payouts linked to the original entitlement ledger entries.
Zero-side-effect simulation
Dry-run a revenue event against a graph's rules without recording anything.
Fail-closed setup
Without an API key the server starts but every call returns an error.
MCPB bundle
Install the v1.1.0 bundle in a compatible client or run from source with Node.js.

Good for

  • Check how a royalty waterfall would split a new payment before it happens
  • Audit which payouts match entitlement ledger entries
  • Test changes to recoupment rules against sample events
  • Let an assistant explain a graph's participants and shares

Pricing

Freemium, from $29 a month

Free sandbox and evaluation key; $99 one-time license; managed plans from $29/month

Prices change. Check payloadhq.github.io before you buy.

RevRule by Payload FAQ

Can it move money or write data?

No. The three tools are read or dry-run only, and RevRule never holds or executes payments.

What do I need to run it?

Node.js and a Payload rail API key in PAYLOAD_RAIL_API_KEY. A free key from the console works for evaluation.

What does RevRule cost?

The README lists a one-time $99 production license; the site also lists managed plans from $29 a month and a free sandbox.

Which transport does it use?

stdio.

Is RevRule by Payload free?

RevRule by Payload has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

How do I add RevRule by Payload to Claude Code?

Run this command in your terminal: claude mcp add revrule-mcp -- npx -y https://github.com/Payloadhq/revrule-mcp/releases/download/v1.1.0/revrule.mcpb

What are the best alternatives to RevRule by Payload?

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

Alternatives to RevRule by Payload

  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

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

    MCP server

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

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government