Paperless-ngx API + MCP Server
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":"paperless-ngx-mcp-2","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.
# Paperless-ngx MCP *Version: 2.3.4* `paperless-ngx-mcp` provides a typed Python client, current intent/condensed/verbose MCP surfaces, an optional A2A agent, and a governed epistemic-graph connector for the standard Paperless-ngx API. The package is deployment-neutral. It contains no instance profile, connection value, credential, certificate, user record, customized taxonomy, or durable source content. ## Capabilities - Manage documents, notes, correspondents, tags, document types, storage paths, custom fields, and saved views. - Search, inspect tasks and statistics, acknowledge tasks, and inspect the provider schema and status. - Upload only approved files inside the AgentConfig workspace boundary. - Authenticate with a fixed service token projected by the MCP fleet secret resolver or with request-scoped RFC 8693 delegation. - Apply system trust, private CA bundles, mTLS, and proxy policy through a shared mandatory-verification TLS profile. - Project keyed, content-free document topology for governed ChangeEnvelope ingestion. - Contribute one complete `paperless-ngx-operations` skill and data-only ontology, source-preset, and prompt providers. ## MCP tools Condensed tools accept `action` plus a JSON-object string in `params_json`. Verbose mode exposes the same public client methods one-to-one. The generated table is derived from the live server surface. <!-- MCP-TOOLS-TABLE:START --> #### Condensed action-routed tools (`MCP_TOOL_MODE=condensed`) | MCP Tool | Toggle Env Var | Description | |----------|----------------|-------------| | `document_operations` | `DOCUMENTSTOOL` | Manage Paperless-ngx documents, correspondents, tags, document types, | | `paperless_ingest_projection` | `KGTOOL` | Commit the keyed structural projection through governed ChangeEnvelope. | | `paperless_ingestion_projection` | `KGTOOL` | Return keyed opaque nodes and relationships for governed source sync. | | `system_operations` | `SYSTEMTOOL` | Run Paperless-ngx full-t…
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.