{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cnpzcrexjy34","handle":"photon-mcp","url":"https://wellknown.network/agents/photon-mcp","links":{"self":"https://wellknown.network/agents/photon-mcp/record.json","html":"https://wellknown.network/agents/photon-mcp","markdown":"https://wellknown.network/agents/photon-mcp/record.md","api":"https://wellknown.network/api/v1/agents/photon-mcp","status":"https://wellknown.network/api/v1/agents/photon-mcp/status","claim":"https://wellknown.network/agents/photon-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/photon-mcp/claim.json","badge":"https://wellknown.network/agents/photon-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/photon-mcp/history","tools":"https://wellknown.network/api/v1/agents/photon-mcp/tools"},"ard":{"identifier":"urn:air::server:photon-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"photon-mcp","summary":"MCP server for the Photon Commerce document extraction API","description":"# Photon Commerce MCP server\n\n[![PyPI](https://img.shields.io/pypi/v/photon-mcp.svg)](https://pypi.org/project/photon-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/photon-mcp.svg)](https://pypi.org/project/photon-mcp/)\n[![CI](https://github.com/Photon-Commerce/Photon-MCP/actions/workflows/ci.yml/badge.svg)](https://github.com/Photon-Commerce/Photon-MCP/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nTurn invoices, receipts, checks, remittances, bank statements, utility bills, pay stubs,\nshipping labels and bills of lading into structured JSON — from inside Claude or any other\nMCP client.\n\nThis is an [MCP](https://modelcontextprotocol.io) server for the\n[Photon Commerce API](https://apidocs.photoncommerce.com/). It runs locally over stdio and\ntalks to nothing but the Photon REST API — no database, no cloud storage, no hosting to\nstand up. You bring your own API credentials and it acts on your behalf.\n\n## Quickstart\n\nYou need Python 3.10 or newer and a set of Photon API credentials\n([get them below](#get-credentials)).\n\n```bash\nclaude mcp add photon -- uvx photon-mcp \\\n  -e PHOTON_CLIENT_ID=... \\\n  -e PHOTON_SECRET_KEY=... \\\n  -e PHOTON_USERNAME=you@example.com \\\n  -e PHOTON_API_KEY=... \\\n  -e PHOTON_PASSWORD=... \\\n  -e PHOTON_ALLOWED_DIRS=/Users/you/Documents/invoices\n```\n\nThen just ask for what you want — *\"pull the totals out of\n~/Documents/invoices/acme.pdf\"* or *\"what kind of document is this?\"*\n\n## Get credentials\n\nIf you don't already have an account, register for a free sandbox one:\n\n```bash\ncurl -X POST https://sandbox-api.photoncommerce.com/api/v4/register \\\n  -F first_name=Jane -F last_name=Doe \\\n  -F email=you@example.com -F password='YourPassw0rd!'\n```\n\nYou get back a `client_id`, `api_key`, `secret_key` and `username`. Those plus your\npassword are the five values the server needs. Sandbox accounts include 20 pages over 14\ndays. For a production account, email <api@photoncommerce.com>.\n\n#…","publisher":null,"homepage":"https://apidocs.photoncommerce.com/","repository":"https://github.com/Photon-Commerce/Photon-MCP/blob/main/CHANGELOG.md","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["claude","document-extraction","invoice","mcp","model-context-protocol","ocr"],"pricing":null,"endpoints":[{"url":"pypi:photon-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.extraction","name":"Data Extraction","confidence":1,"provenance":"derived"},{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":1,"provenance":"declared"},{"slug":"documents.ocr","name":"OCR","confidence":1,"provenance":"declared"}],"categories":["documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"photon-mcp","registry":"pypi","observedAt":"2026-10-28T19:22:54.301Z","publishedAt":"2026-08-19T17:50:40.151961Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"photon-mcp","url":"https://pypi.org/project/photon-mcp/","firstSeenAt":"2026-09-10T09:26:18.659Z","fetchedAt":"2026-10-28T19:22:09.068Z","normalizedAt":"2026-10-28T19:22:09.068Z"}]},"firstSeenAt":"2026-09-10T09:26:18.659Z","updatedAt":"2026-10-28T19:22:54.301Z"}