Skip to main content

FOR AI AGENTS

Your agent can read documents like databases.

Talonic turns unstructured documents into typed, queryable data. Three integration paths: REST API, Node SDK, or MCP server. Every response includes confidence scores, provenance, and cost.

Read the docs


01 THREE WAYS TO INTEGRATE

Pick the path that fits your stack.

REST API

Direct HTTP calls to api.talonic.com

Send a document, get structured data back. No SDK required.

curl -X POST https://api.talonic.com/v1/extract \
  -H "Authorization: Bearer $TALONIC_API_KEY" \
  -F "file=@invoice.pdf"

API reference

NODE SDK

Typed client for Node.js and TypeScript

Install, configure, extract. Full type safety.

npm install @talonic/node
import { Talonic } from "@talonic/node";
const client = new Talonic({ apiKey: process.env.TALONIC_API_KEY! });
const result = await client.extract({ file_path: "invoice.pdf" });

SDK docs

MCP SERVER

Tool calls for agent frameworks

Works with Claude Desktop, Cursor, Cline, Continue, Cowork.

npx @talonic/mcp

MCP docs

02 RESPONSE SHAPE

What your agent gets back

{
  "extraction_id": "ext_9f8a7b6c",
  "status": "complete",
  "data": {
    "rows": [
      {
        "vendor_name": {
          "value": "Acme Industrial GmbH",
          "confidence": 0.97,
          "phase": 1,
          "reasoning": "Exact match from field registry"
        },
        "contract_value": {
          "value": 248000.00,
          "confidence": 0.94,
          "phase": 2,
          "reasoning": "Extracted from clause 4.2"
        }
      }
    ]
  }
}

Every field carries confidence, phase, and reasoning. Your agent decides which values to trust.

03 COST TRANSPARENCY

Cost on every call

X-Talonic-Cost-Credits: 70
X-Talonic-Cost-EUR: 0.07
X-Talonic-Balance-Credits: 64930
GET /v1/credits/balance

{
  "balance_credits": 64930,
  "burn_rate_30d_credits": 12400,
  "projected_runway_days": 157
}

Track spend per call. Check runway before committing to batch jobs. Auto top-up is human-gated — your agent can request it but can't enable it.

04 FORMATS

Supported formats

25+ formats: PDF, DOCX, XLSX, PPTX, PNG, JPG, TXT, MD, HTML, JSON, CSV, XML, EML, ZIP, and more.

05 RESOURCES

Resources

Documentation
talonic.com/docs