localparse-mcp 0.1.0

MCP server for LocalParse — accurate document parsing for Cursor, Claude Desktop, and other MCP clients.

localparse-mcp

An MCP server that gives your coding agent (Cursor, Claude Desktop, etc.) accurate document parsing via LocalParse — table-detection recovery + arithmetic identity checks — instead of letting it write throwaway OCR scripts.

Tools

Tool	What it does
parse_document(path, result_type)	Parse a local file (PDF/image/PPTX/…).
parse_url(url, result_type)	Download a remote doc and parse it.
parse_folder(path, case_id, resume)	Ingest a whole folder into a named case; re-runs only parse changed files.
get_structured(job_id)	Fetch the structured ingestion contract for a job.
case_manifest(case_id)	List a case's ingested docs (path + hash + status).
case_failures(case_id)	List a case's failed docs for reingest.

result_type ∈ markdown (default), text, json, structured.

Configure your client

You need a LocalParse API key (LOCALPARSE_API_KEY).

Cursor — ~/.cursor/mcp.json (or project .cursor/mcp.json)

{
  "mcpServers": {
    "localparse": {
      "command": "uvx",
      "args": ["localparse-mcp"],
      "env": { "LOCALPARSE_API_KEY": "lp-your-key" }
    }
  }
}

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "localparse": {
      "command": "uvx",
      "args": ["localparse-mcp"],
      "env": { "LOCALPARSE_API_KEY": "lp-your-key" }
    }
  }
}

Then ask the agent things like "parse the PDFs in ./data-room into case acme and tell me which tables don't reconcile."

Local development (before it's on PyPI)

Run the server straight from the repo and point the client at it:

{
  "mcpServers": {
    "localparse": {
      "command": "uv",
      "args": ["run", "--directory", "/abs/path/to/Agent-ingestor", "localparse-mcp"],
      "env": { "LOCALPARSE_API_KEY": "lp-your-key" }
    }
  }
}

Point at a self-hosted parser by also setting LOCALPARSE_BASE_URL.