Skip to content
MCP server

Cedulon

Policy-gated agent spending with signed receipts and audit against the payment rail

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.18.0
Listing updated
3 days ago

About Cedulon

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

The idea is that a payment an agent makes without a receipt shows up as a finding rather than vanishing. Each spend request passes a default-deny policy check; if allowed, it yields a receipt encoded as deterministic CBOR and signed as COSE_Sign1 with Ed25519. Each receipt carries the previous receipt's hash, and epochs close with checkpoints, so removing or editing a receipt is visible.

The audit tool reconciles that chain against the rail's own extract. A settlement with no matching receipt is reported as a finding. The site is explicit that nothing here moves money: the server settles on an in-process mock rail and holds no wallet, and the README says it makes no network requests and has no telemetry.

Policy limits are set through environment variables: per-payment amount, cumulative amount, payment count in a window, allowed payees, currencies and tools. The demo defaults are small. State is in memory unless CEDULON_STATE_PATH points to a JSON file.

Install

Run in a terminal

claude mcp add cedulon -- npx -y @cedulon/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cedulon": {
      "command": "npx",
      "args": [
        "-y",
        "@cedulon/mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cedulon": {
      "command": "npx",
      "args": [
        "-y",
        "@cedulon/mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "cedulon": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cedulon/mcp-server"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "cedulon": {
      "command": "npx",
      "args": [
        "-y",
        "@cedulon/mcp-server"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "cedulon": {
      "command": "npx",
      "args": [
        "-y",
        "@cedulon/mcp-server"
      ]
    }
  }
}

Configuration

  • CEDULON_STATE_PATHOptional JSON file that persists the in-process ledger
  • CEDULON_MAX_AMOUNTPer-payment amount cap (demo default 10)
  • CEDULON_MAX_CUMULATIVEWindow cumulative cap (demo default 30)
  • CEDULON_MAX_PAYMENTSWindow payment-count cap (demo default 3)

Tools this server provides (5)

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

cedulon_spend
Policy-gated spend that returns a signed receipt or a denial reason.
cedulon_audit
Reconciles the receipt chain against the rail extract.
cedulon_verify_receipt
Verifies receipt COSE bytes.
cedulon_export_ledger
Exports receipts, checkpoint and extract with audit findings.
cedulon_status
Shows version, policy summary, receipt count and chain head.

What it does

Default-deny policy
Refuses spends over a limit, to unknown payees or with a replayed nonce, and records the reason.
Signed receipts
Allowed spends yield COSE_Sign1 receipts signed with Ed25519.
Hash-chained ledger
Each receipt holds the previous receipt's hash and epochs close with checkpoints.
Rail reconciliation
Pairs every settlement in the rail extract with a receipt and flags the ones without.
Receipt verification
Verifies receipt bytes against a public key.
Local only
Runs over stdio on a mock rail with no wallet, no network and no telemetry.

Good for

  • Prototype spend controls for an agent that pays for API calls
  • Demonstrate how an unreceipted payment is caught by audit
  • Verify a receipt's signature offline
  • Export a ledger with receipts, checkpoint and findings
  • Test policy limits before wiring a real rail

Pricing

Open source

Free; no price published

Prices change. Check cedulon.com before you buy.

Cedulon FAQ

Does it move real money?

No. It settles on an in-process mock rail and holds no wallet.

Does it send data anywhere?

The README says it makes no network requests and contains no HTTP client or telemetry.

How do I persist the ledger?

Set CEDULON_STATE_PATH to a JSON file; otherwise state lives in memory.

How do I run it?

Use npx -y @cedulon/mcp-server in Claude Desktop, Claude Code or Cursor.

Is Cedulon free?

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

How do I add Cedulon to Claude Code?

Run this command in your terminal: claude mcp add cedulon -- npx -y @cedulon/mcp-server

What are the best alternatives to Cedulon?

The closest alternatives to Cedulon are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to Cedulon

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

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

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. 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