# RevRule by Payload

> RevRule by Payload is a freemium MCP server for finance and payments. Read revenue-split graphs, review payout evidence and dry-run events, with no writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** CLI, self-hosted, API
- **Website:** https://payloadhq.github.io/revrule.html
- **Repository:** https://github.com/payloadhq/revrule-mcp
- **MCP Registry name:** io.github.payload-tools/revrule-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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.

## 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

- [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/revrule-by-payload
