MCP server for the Photon Commerce document extraction API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"photon-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Photon Commerce MCP server [](https://pypi.org/project/photon-mcp/) [](https://pypi.org/project/photon-mcp/) [](https://github.com/Photon-Commerce/Photon-MCP/actions/workflows/ci.yml) [](LICENSE) Turn invoices, receipts, checks, remittances, bank statements, utility bills, pay stubs, shipping labels and bills of lading into structured JSON — from inside Claude or any other MCP client. This is an [MCP](https://modelcontextprotocol.io) server for the [Photon Commerce API](https://apidocs.photoncommerce.com/). It runs locally over stdio and talks to nothing but the Photon REST API — no database, no cloud storage, no hosting to stand up. You bring your own API credentials and it acts on your behalf. ## Quickstart You need Python 3.10 or newer and a set of Photon API credentials ([get them below](#get-credentials)). ```bash claude mcp add photon -- uvx photon-mcp \ -e PHOTON_CLIENT_ID=... \ -e PHOTON_SECRET_KEY=... \ -e PHOTON_USERNAME=you@example.com \ -e PHOTON_API_KEY=... \ -e PHOTON_PASSWORD=... \ -e PHOTON_ALLOWED_DIRS=/Users/you/Documents/invoices ``` Then just ask for what you want — *"pull the totals out of ~/Documents/invoices/acme.pdf"* or *"what kind of document is this?"* ## Get credentials If you don't already have an account, register for a free sandbox one: ```bash curl -X POST https://sandbox-api.photoncommerce.com/api/v4/register \ -F first_name=Jane -F last_name=Doe \ -F email=you@example.com -F password='YourPassw0rd!' ``` You get back a `client_id`, `api_key`, `secret_key` and `username`. Those plus your password are the five values the server needs. Sandbox accounts include 20 pages over 14 days. For a production account, email <api@photoncommerce.com>. #…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.