MCP server for DocReadi — document data extraction for finance, in your AI client.
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":"docreadi-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.
# docreadi-mcp A **local** [MCP](https://modelcontextprotocol.io) server for **DocReadi** — document data extraction for finance. It runs on your machine, reads documents off your disk, and calls the hosted DocReadi API with your API key, so an AI client (Claude Desktop, Claude Code, Cursor, …) can extract documents and query your DocReadi corpus without leaving the chat. > **Status: v1 published** — on PyPI as > [`docreadi-mcp`](https://pypi.org/project/docreadi-mcp/); run with > `uvx docreadi-mcp` (see Install / configure below). Plan + history: > `../../MCP_SERVER_PLAN.md`. ## How it works Your MCP client spawns `docreadi-mcp` as a local subprocess and talks to it over stdio. The server is a thin courier — all extraction/storage happens on the hosted DocReadi API; the server just translates tool calls into HTTPS requests and (for ingestion) reads local files. Your API key lives only in your client config, never in this repo. ## Install / configure Add the server to your MCP client config with your DocReadi API key (get one at **docreadi.com → Settings → API keys**): ```jsonc { "mcpServers": { "docreadi": { "command": "uvx", "args": ["docreadi-mcp"], "env": { "DOCREADI_API_KEY": "dr_live_…" // "DOCREADI_BASE_URL": "https://docreadi.com" // override if self-hosting } } } } ``` | Env var | Required | Default | |---|---|---| | `DOCREADI_API_KEY` | yes | — | | `DOCREADI_BASE_URL` | no | `https://docreadi.com` | ## Tools | Tool | What it does | |---|---| | `check_connection` | First-run self-test — is DocReadi reachable and is your API key valid? Never errors; returns a diagnostic. | | `extract_document` | Extract structured data from a **local** PDF/JPG/PNG — uploads, waits for extraction, returns the fields + line items + totals + confidence. | | `get_document` | Fetch a document's status + extracted data by id. | | `extract_adhoc` | One-off, non-destructive extraction of caller-defined fields from a doc…
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.