Skip to content
MCP server

Orphograph

Anchor a file's SHA-256 fingerprint to Bitcoin from your coding assistant

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI
Runs
Locally
Version
0.1.6
Listing updated
3 days ago

About Orphograph

Orphograph is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.

Only fingerprints leave the machine. For a single file the local Python process computes SHA-256 and SHA-512 hashes and sends those plus an optional label, while a folder anchor also sends a manifest of relative paths, sizes and digests built as an RFC 6962 Merkle tree. The result is a receipt with an ID and URL, whose Bitcoin status stays pending until the calendars commit to a block, usually hours later.

The server is a single MIT-licensed Python file with no third-party dependencies, started by the host over stdio. Besides files and folders it can anchor assistant output, with an optional salt for short or guessable text, and record every step of an agent run under one receipt. Verification tools look up a receipt, check an exact output against it, and walk an edit-lineage chain. A receipt lookup does not consult the chain, so the README points to the ots verify command for that.

Without a key, anchors are rate-limited to three per 24 hours per IP. An optional API key applies a subscription or credit pack, and an optional x402 wallet setting lets agents pay one cent per anchor in USDC.

Install

Run in a terminal

claude mcp add orphograph --env ORPHO_API_KEY='<ORPHO_API_KEY>' -- npx -y https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "orphograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb"
      ],
      "env": {
        "ORPHO_API_KEY": "<ORPHO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "orphograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb"
      ],
      "env": {
        "ORPHO_API_KEY": "<ORPHO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "orphograph": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb"
      ],
      "env": {
        "ORPHO_API_KEY": "<ORPHO_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "orphograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb"
      ],
      "env": {
        "ORPHO_API_KEY": "<ORPHO_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "orphograph": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb"
      ],
      "env": {
        "ORPHO_API_KEY": "<ORPHO_API_KEY>"
      }
    }
  }
}

Configuration

  • ORPHO_API_KEYOptional API key issued from https://orphograph.com/account.html. Without it, anchors are subject to the free-tier rate limit (three anchors per twenty-four hours per IP). With it, the customer's subscription or Pack credits apply.
  • ORPHO_BASE_URLBase URL for the Orphograph API. Defaults to https://orphograph.com. Override only for testing or self-hosted instances.
  • ORPHO_X402_PAYER_KEY_FILEOptional. Path to a chmod-600 file holding the hex private key of a dedicated Base wallet with USDC. With ORPHO_X402_DAILY_CAP_CENTS set too, anchors past the free tier are paid with x402 (1 cent today). The key never leaves the machine.
  • ORPHO_X402_DAILY_CAP_CENTSOptional. The most this server may pay in one UTC day, in cents. Paying stays off unless this and ORPHO_X402_PAYER_KEY_FILE are both set.
  • ORPHO_X402_MAX_CENTS_PER_CALLOptional. The most one anchor may cost, in cents. Default 5.

Tools this server provides (8)

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

orphograph_anchor_file
Hashes a local file and anchors its fingerprint on Bitcoin.
orphograph_anchor_folder
Anchors a Merkle root covering every file in a folder.
orphograph_anchor_output
Hashes and anchors assistant output.
orphograph_verify_receipt
Looks up what was recorded for a receipt.
orphograph_verify_lineage
Walks an edit-lineage chain from a receipt.
orphograph_list_vault
Lists a subscriber's receipts.
orphograph_anchor_run
Anchors every step of an agent run under one receipt.
orphograph_verify_output
Checks whether a receipt covers an exact output.

What it does

Local hashing
Files are hashed in the local process; bodies are never uploaded.
Folder anchoring
One Merkle root covers every file in a folder.
Output receipts
Anchor an agent's output, with optional salt, at the time it was produced.
Run anchoring
Anchor every step of an agent run under a single receipt.
Receipt verification
Check receipts, edit lineage and whether a receipt covers an exact output.
Pay-as-you-go option
Agents can pay one cent per anchor in USDC on Base via x402.

Good for

  • Prove a draft existed before a given date
  • Keep a tamper-evident record of what an agent produced
  • Anchor a project folder's state at a release
  • Timestamp a transcript or report
  • Verify a receipt a colleague shared

Pricing

Freemium, from $9 a month

3 free anchors per 24h per IP; $9/mo subscription; credit packs available

Prices change. Check orphograph.com before you buy.

Orphograph FAQ

Does my file get uploaded?

No. Only SHA-256 and SHA-512 fingerprints and an optional label are sent; folder anchors add relative paths and sizes.

How many anchors are free?

Three per 24 hours per IP without an API key.

How much do paid options cost?

A subscription is $9 a month, a 25-credit pack and a 200-anchor crypto pack ($20) are sold, and agents can pay 1 cent per anchor with x402.

How is it installed?

Run pip install orphograph-mcp, then claude mcp add orphograph -- orphograph-mcp.

When is the Bitcoin pin confirmed?

Receipts show pending until the calendars commit to a Bitcoin block, usually within hours.

Is Orphograph free?

Orphograph has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

How do I add Orphograph to Claude Code?

Run this command in your terminal: claude mcp add orphograph --env ORPHO_API_KEY='<ORPHO_API_KEY>' -- npx -y https://github.com/Orphograph/Orphograph/releases/download/mcp-v0.1.6/orphograph-mcp-0.1.6.mcpb

What are the best alternatives to Orphograph?

The closest alternatives to Orphograph are REA, Agent Roast, Midplane, Leash and ASTra.

Alternatives to Orphograph

  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. 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
  3. 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
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents