Agent

Agent

Insurance extraction for agents.

PolDex gives agents machine-readable access to insurance document extraction. Commercial P&C is the first live wedge; MCP tools, CLI commands, OpenAPI contracts, live schema discovery, and guarded credit-spend workflows are the expansion rails.

Read agent docs ->OpenAPI MCP Registry

01

MCP server

Expose PolDex tools directly inside agent runtimes. Agents can list schemas, estimate extraction, run batches, inspect jobs, and download artifacts.

npm install -g @poldex/mcp-server
POLDEX_API_KEY=pd_live_YOUR_KEY poldex-mcp-server

02

CLI

Give coding agents and terminal workflows a direct command surface for schemas, estimates, extraction, batch status, and downloads.

npm install -g @poldex/cli
poldex extract policy.pdf --schema commercial_gl --yes --json

03

OpenAPI

Let custom agent frameworks inspect endpoints, request bodies, auth requirements, response shapes, and error contracts.

curl https://poldex-web.pages.dev/openapi.json

Discovery

Machine-readable entry points.

These files let agents discover the API, schemas, MCP command, CLI command, authentication model, and safety rules without needing a human to click through the site.

https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.lordolami%2Fpoldex

Official MCP Registry

Open the machine-readable resource.

OpenAPI

Open the machine-readable resource.

/.well-known/poldex-agent.json

Agent manifest

Open the machine-readable resource.

LLM guide

Open the machine-readable resource.

Docs

Open the machine-readable resource.

Client Templates

Copy-paste setup for common agent environments.

These examples use the official registry-ready package, pin the current MCP server version, and keep the API key in the client environment.

Claude Desktop

Add PolDex as a local stdio MCP server in Claude Desktop.

{
  "mcpServers": {
    "poldex": {
      "command": "npx",
      "args": ["-y", "@poldex/mcp-server@0.0.3"],
      "env": {
        "POLDEX_API_KEY": "pd_live_YOUR_KEY",
        "POLDEX_API_BASE_URL": "https://poldex-api.plain-water-cd0f.workers.dev"
      }
    }
  }
}

Claude Code

Use Claude Code's JSON add command for the same local stdio server.

claude mcp add-json poldex '{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@poldex/mcp-server@0.0.3"],
  "env": {
    "POLDEX_API_KEY": "pd_live_YOUR_KEY",
    "POLDEX_API_BASE_URL": "https://poldex-api.plain-water-cd0f.workers.dev"
  }
}'

Cursor

Add this to Cursor MCP settings or the user's Cursor MCP JSON config.

{
  "mcpServers": {
    "poldex": {
      "command": "npx",
      "args": ["-y", "@poldex/mcp-server@0.0.3"],
      "env": {
        "POLDEX_API_KEY": "pd_live_YOUR_KEY",
        "POLDEX_API_BASE_URL": "https://poldex-api.plain-water-cd0f.workers.dev"
      }
    }
  }
}

Codex-style agents

Add PolDex to a Codex-style TOML MCP configuration.

[mcp_servers.poldex]
command = "npx"
args = ["-y", "@poldex/mcp-server@0.0.3"]
env = { POLDEX_API_KEY = "pd_live_YOUR_KEY", POLDEX_API_BASE_URL = "https://poldex-api.plain-water-cd0f.workers.dev" }

Terminal agents

For terminal-first agents, run the MCP server or use the CLI safe flow.

export POLDEX_API_KEY=pd_live_YOUR_KEY
npx -y @poldex/mcp-server@0.0.3

# Safe CLI flow:
poldex schemas --json
poldex estimate policy.pdf --schema commercial_gl
poldex extract policy.pdf --schema commercial_gl --yes --json

Workflow

The agent path.

01

Discover supported schemas.

02

Estimate pages and credits.

03

Confirm extraction cost.

04

Process files, URLs, or text.

05

Poll status or receive connector events.

06

Download JSON, CSV, XLSX, or ZIP artifacts.

Hosted MCP

Remote MCP is under evaluation.

Current surface

The live PolDex MCP surface is currently local stdio through @poldex/mcp-server.

Remote requirement

A hosted remote MCP endpoint remains roadmap work because it needs authenticated tenant isolation, per-tool spend confirmation, rate limits, audit logging, and the same credit safety model as the API.

Safety

Agents do not spend credits by accident.

The MCP tool requires confirm_cost: true. The CLI requires --yes. Direct async extraction requires an Idempotency-Key. The estimate path is always available before processing.

poldex schemas --json
poldex estimate policy.pdf --schema commercial_gl
poldex extract policy.pdf --schema commercial_gl --yes --json
poldex batch bat_123 --json
poldex download bat_123 results.zip --out ./results.zip

Build against the live contracts.

Start with OpenAPI or use the docs agent section for MCP and CLI setup.

OpenAPI ->Agent docs