Optical Context MCP Server

Compress large OCR-heavy PDFs into dense packed images for agent workflows.

Local serverstdioPython

What is the Optical Context MCP Server?

Compress large OCR-heavy PDFs into dense packed images for agent workflows.

The short version

Compress OCR-heavy PDFs into dense packed images so agents can work with long visual documents.

  • reads a local PDF from the MCP host machine
  • extracts page markdown and embedded images with Mistral OCR
  • packs that content into dense PNGs that preserve visual grouping
  • optionally sizes embedded figures with a bundled technical-document model
  • stores a manifest and temp job artifacts for follow-up retrieval
  • lets an agent pull only the packed images it needs

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
compress_pdfrun OCR plus recomposition and create a stored job
get_job_manifestload metadata for an existing job
get_packed_imagesfetch one or more packed PNGs from an existing job

How to install the Optical Context MCP Server

{
  "mcpServers": {
    "optical-context": {
      "command": "uvx",
      "args": ["optical-context-mcp"],
      "env": {
        "MISTRAL_API_KEY": "your-value",
        "OPTICAL_CONTEXT_ADAPTIVE_MODEL_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
MISTRAL_API_KEYCredential the server authenticates with.Yes
OPTICAL_CONTEXT_ADAPTIVE_MODEL_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Optical Context MCP to compress pdf.”
  • “Use Optical Context MCP to get job manifest.”
  • “Use Optical Context MCP to get packed images.”

Frequently asked questions

Compress large OCR-heavy PDFs into dense packed images for agent workflows. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.