DocsAgent Interfaces
Initialize API Access
Agents

Agent Interfaces

Agents can discover PolDex through OpenAPI, MCP, CLI, schema endpoints, and agent manifest files.

OpenAPI/openapi.json
Agent manifest/.well-known/poldex-agent.json
LLM context/llms.txt and /llms-full.txt
Schema registryGET /v1/schemas

MCP

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

Hosted MCP metadata is available at GET /v1/mcp. Authenticated hosted calls use POST /v1/mcp/call for schema discovery, classification, estimate, extraction, polling, artifact listing, connector events, parser-output import, and Reducto import.

POST /v1/mcp/call
curl -X POST https://poldex-api.plain-water-cd0f.workers.dev/v1/mcp/call \
  -H "x-api-key: pd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"poldex.estimate","arguments":{"schema":"commercial_gl","items":[{"source_type":"text","source_name":"sample.txt","text":"ACORD 25 certificate"}]}}'

CLI

CLI
npm install -g @poldex/cli
poldex schemas --json
poldex classify --text "ACORD 25 certificate" --json
poldex estimate policy.pdf --schema commercial_gl
poldex extract policy.pdf --schema commercial_gl --yes --json
poldex artifacts job_123 --json
poldex parser-import --schema coi --markdown-file parsed.md

Safe flow

Agents should discover schemas, estimate cost, request explicit confirmation, then extract and download artifacts.