flexorch-mcp

MCP server for FlexOrch — SDK for machines.

Connect Claude and other MCP-compatible agents to the FlexOrch document intelligence pipeline. Process documents, extract structured data, detect PII, and export LLM-ready datasets — all through natural language tool calls.

What this is

flexorch-mcp is a thin proxy that exposes the FlexOrch API as MCP tools. All processing happens on FlexOrch's managed infrastructure. A FlexOrch account and API key are required.

For humans writing code: use flexorch-sdk (Python) or flexorch-sdk-js (TypeScript).
For agents: use this package.

Related MCP server: pdfmux

Tools

Installation

pip install flexorch-mcp

Requires Python 3.10+.

Configuration

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "flexorch": {
      "command": "flexorch-mcp",
      "env": {
        "FLEXORCH_API_KEY": "dfx_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP config:

{
  "flexorch": {
    "command": "flexorch-mcp",
    "env": {
      "FLEXORCH_API_KEY": "dfx_your_key_here"
    }
  }
}

Get your API key from app.flexorch.com/settings.

Verify connection

flexorch-mcp --check
# → FlexOrch API key: dfx_xxx*** ✓
# → Connection: OK (api.flexorch.com)
# → Plan: Starter (1,200 credits/mo)
# → Tools: 6 registered

Example agent workflow

User: "Process this invoice and export it as JSONL for fine-tuning."

Agent:
  1. process_document(file_url="https://...")   → job_id: 1234
  2. get_job_status(1234)                        → completed, execution_id: 567
  3. get_extraction_result(567)                  → vendor, total, date, PII masked
  4. build_dataset(execution_id=567)             → dataset_id: 89, build_job_id: 1235
  5. get_job_status(1235)                        → completed
  6. export_dataset(89, format="jsonl")          → download_url

Plan limits

All FlexOrch plan limits apply to MCP tool calls. Credits are consumed per document processed.

Security

• API key is read from the FLEXORCH_API_KEY environment variable — never passed as a tool argument

• No data is stored or cached by this server — stateless proxy

• PII masking is applied by FlexOrch's pipeline before results are returned

• All communication with api.flexorch.com uses HTTPS

Related

• flexorch-audit — Standalone PII detection and document quality scoring (no account required)

• flexorch-sdk — Python SDK for developers

• flexorch-sdk-js — TypeScript SDK for developers

• docs.flexorch.com — Full documentation

License

MIT — see LICENSE.