Skip to content
MCP server

Talonic

Document extraction MCP server that returns schema-validated JSON from PDFs and scans

Runs locallyStatus and history
Install
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/mcp

Add 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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents