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.
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"NODE SDK
Typed client for Node.js and TypeScript
Install, configure, extract. Full type safety.
npm install @talonic/nodeimport { Talonic } from "@talonic/node";
const client = new Talonic({ apiKey: process.env.TALONIC_API_KEY! });
const result = await client.extract({ file_path: "invoice.pdf" });MCP SERVER
Tool calls for agent frameworks
Works with Claude Desktop, Cursor, Cline, Continue, Cowork.
npx @talonic/mcp02 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: 64930GET /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
- OpenAPI spec
- talonic.com/openapi.json
- Documentation
- talonic.com/docs
- Node SDK
- talonic.com/docs/sdk
- MCP Server
- talonic.com/docs/mcp
- API Reference
- talonic.com/docs/api
- Pricing
- talonic.com/pricing