Talonic
Document extraction MCP server that returns schema-validated JSON from PDFs and scans
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 0.1.94
- Listing updated
- 2 days ago
About Talonic
Talonic is a freemium MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Talonic's server hands an agent a full document workflow rather than a single extract call. The README lists 36 public tools, covering extraction, OCR to markdown, search and filtering across ingested documents, saved schemas, a Field Registry of canonical concepts, and a task queue for documents that need an agent's judgement.
Behind it sits Talonic's pay-as-you-go API: every account gets 5,000 free credits a month with a hard cap, then prepaid packs. Ingesting a page costs 200 credits (EUR 0.20), and fields already resolved from your Field Registry are free. A balance and pricing tool lets an agent check spend before running a job.
It runs locally over stdio with an API key from app.talonic.com, or as a hosted Streamable HTTP server at mcp.talonic.com for Claude.ai connectors. It suits teams in logistics, finance or contract operations that want agents reading invoices, contracts and forms.
Install
Run in a terminal
claude mcp add talonic-mcp --env TALONIC_API_KEY='<TALONIC_API_KEY>' -- npx -y @talonic/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"talonic-mcp": {
"command": "npx",
"args": [
"-y",
"@talonic/mcp"
],
"env": {
"TALONIC_API_KEY": "<TALONIC_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"talonic-mcp": {
"command": "npx",
"args": [
"-y",
"@talonic/mcp"
],
"env": {
"TALONIC_API_KEY": "<TALONIC_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"talonic-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@talonic/mcp"
],
"env": {
"TALONIC_API_KEY": "<TALONIC_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"talonic-mcp": {
"command": "npx",
"args": [
"-y",
"@talonic/mcp"
],
"env": {
"TALONIC_API_KEY": "<TALONIC_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"talonic-mcp": {
"command": "npx",
"args": [
"-y",
"@talonic/mcp"
],
"env": {
"TALONIC_API_KEY": "<TALONIC_API_KEY>"
}
}
}
}Configuration
TALONIC_API_KEYYour Talonic API key. Get one at https://app.talonic.com.Required
Tools this server provides (22)
Taken from the project documentation; the running server may differ.
- talonic_extract
- Extract schema-validated JSON from a document, with per-field confidence scores.
- talonic_request_upload
- Get a browser upload link for files too large to pass through a hosted connector.
- talonic_to_markdown
- OCR a document to clean markdown.
- talonic_search
- Omnisearch across documents, fields, sources and schemas.
- talonic_filter
- Filter documents by extracted field values.
- talonic_get_document
- Fetch a document's metadata, processing status and links.
- talonic_list_schemas
- List saved schemas with their definitions.
- talonic_save_schema
- Save a reusable schema to the workspace.
- talonic_get_balance
- Read credit balance, EUR value, burn rate and runway.
- talonic_get_pricing
- Read the public per-unit credit pricing catalog.
- talonic_get_usage
- Break down credit consumption per function over a trailing window.
- talonic_list_fields
- List the Field Registry's canonical concepts.
- talonic_get_field
- Concept card for one field.
- talonic_field_values
- One concept's current values across documents, with provenance.
- talonic_find_data
- Resolve a concept in the user's words to fields, values, documents and passages.
- talonic_list_agent_tools
- List the platform's agent tool registry.
- talonic_invoke_agent_tool
- Run one platform agent tool directly with your own arguments.
- talonic_list_agent_tasks
- List documents parked at agent stages.
- talonic_get_agent_task
- Fetch one agent task's input snapshot and output contract.
- talonic_claim_agent_task
- Acquire or reclaim a leased agent task.
- talonic_heartbeat_agent_task
- Extend the current claim lease on an agent task.
- talonic_submit_agent_task
- Submit an agent task's typed outputs and resume the document.
What it does
- Schema-validated extraction
- talonic_extract returns JSON checked against your schema, with per-field confidence scores.
- OCR to markdown
- talonic_to_markdown turns scans and PDFs into clean markdown.
- Search and filter
- Find documents by meaning or by extracted field values such as equals, greater than or between.
- Field Registry
- List canonical fields with synonyms, maturity and example values across documents.
- Budget awareness
- Balance, usage and pricing tools let an agent predict and track credit spend.
- Agent task queue
- Claim, heartbeat and submit leased tasks for documents parked at agent stages.
Good for
- Pull vendor, total and due date from invoices into JSON
- Convert scanned contracts to markdown for downstream agents
- Find every document where an extracted field passes a threshold
- Save a reusable schema and reuse it across document batches
- Let an agent monitor credit balance before a large batch
Pricing
Freemium
5,000 free credits per month; pay as you go at EUR 0.20 per ingested page, packs from EUR 10
Prices change. Check talonic.com before you buy.
Talonic FAQ
How is it priced?
The API and MCP server are pay as you go, with 5,000 free credits a month and no card needed. Page ingest is EUR 0.20 per page, and prepaid packs start at EUR 10.
What happens when the free credits run out?
The free tier is a hard cap. The API returns 429 until credits reset next month or you buy a pack.
How do I run it?
Install the npm package @talonic/mcp as a stdio server with TALONIC_API_KEY set, or use the hosted server at mcp.talonic.com.
Can an agent buy credits itself?
Only after a human enables auto top-up in billing settings. The agent cannot enable it.
Is Talonic free?
Talonic has a free plan, with paid plans for more usage or features.
How do I add Talonic to Claude Code?
Run this command in your terminal: claude mcp add talonic-mcp --env TALONIC_API_KEY='<TALONIC_API_KEY>' -- npx -y @talonic/mcp
What are the best alternatives to Talonic?
The closest alternatives to Talonic are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.
Alternatives to Talonic

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents