@photon-rs/mcp

Photon MCP server — stamp files on the Bitcoin blockchain from any MCP-capable AI assistant via Photon by RocketShoes.

Photon uses OpenTimestamps to anchor the SHA-256 of a file into the Bitcoin blockchain. The proof is portable, cryptographically verifiable, and survives the vendor that issued it — useful for student portfolios, microcredential badges, contracts, and anything else where you need durable proof-of-existence.

Tools

• photon_stamp_file — upload a local file and stamp its hash.
• photon_verify — check whether a SHA-256 has been stamped.
• photon_list_stamps — list your stamps.

Install

When @photon-rs/mcp is published to npm:

npx @photon-rs/mcp login       # one-time browser sign-in

This opens your browser, signs you in to Photon, and writes credentials to ~/.photon/credentials.json (mode 0600).

Local-build fallback

If you're running from a checkout of the photon monorepo (e.g. before the npm publish, or for local development):

pnpm -F mcp build
node apps/mcp/dist/server.js login

Same browser sign-in flow, same credentials file. No env overrides needed in either path — the API endpoint is baked in.

Use from Claude Code

Add to your Claude Code MCP config (typically ~/.claude/settings.json):

{
  "mcpServers": {
    "photon": {
      "command": "npx",
      "args": ["@photon-rs/mcp"]
    }
  }
}

Then ask Claude: "Stamp this file: /path/to/document.pdf".

Claude will hash the file locally, upload it to your Photon account, and return the stamp ID. Bitcoin confirmation takes ~1 hour.

Environment overrides

• PHOTON_API_URL — API base URL (default: https://api.photon.rocketshoes.io).
• PHOTON_WEB_URL — web app URL, used for login flow (default: https://photon.rocketshoes.io).
• PHOTON_FIREBASE_API_KEY — Firebase web API key (baked at login time).

Security

• Credentials are stored at ~/.photon/credentials.json with mode 0600.
• Uploaded files live in your Photon account's Firebase Storage bucket.
• Only the hash is anchored on Bitcoin; the file itself never leaves Google Cloud and is not public.

Source

Part of the Photon monorepo. License: Apache-2.0.