# Orphograph

> Orphograph is a freemium MCP server for security. Anchor a file's SHA-256 fingerprint to Bitcoin from your coding assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** CLI
- **Website:** https://orphograph.com/mcp.html
- **Repository:** https://github.com/orphograph/orphograph/tree/HEAD/mcp
- **MCP Registry name:** io.github.Orphograph/orphograph
- **Categories:** security, files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## Tools

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

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/orphograph
