# Talonic

> Talonic is a freemium MCP server for files and documents. Document extraction MCP server that returns schema-validated JSON from PDFs and scans. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://talonic.com
- **Repository:** https://github.com/talonicdev/talonic-mcp
- **MCP Registry name:** io.github.talonicdev/talonic-mcp
- **Categories:** files and documents, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add talonic-mcp --env TALONIC_API_KEY='<TALONIC_API_KEY>' -- npx -y @talonic/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "talonic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@talonic/mcp"
      ],
      "env": {
        "TALONIC_API_KEY": "<TALONIC_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "talonic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@talonic/mcp"
      ],
      "env": {
        "TALONIC_API_KEY": "<TALONIC_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "talonic-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@talonic/mcp"
      ],
      "env": {
        "TALONIC_API_KEY": "<TALONIC_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "talonic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@talonic/mcp"
      ],
      "env": {
        "TALONIC_API_KEY": "<TALONIC_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "talonic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@talonic/mcp"
      ],
      "env": {
        "TALONIC_API_KEY": "<TALONIC_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/talonic
