Skavio PDF, OCR & Document Processing MCP

Skavio Processing API

New customer MCP onboarding (9 November 2026): For self-service processing tools, open the Agent Tools dashboard, create a company or choose Continue with Skavio account using a verified main getskavio.com login. Existing Agent Tools accounts require explicit linking after signing in to both accounts; identical email addresses alone do not grant access. Generate an Agent Tools API key and connect to `https://getskavio.com/agent-tools/mcp`. The separate `/processing/mcp` documented below remains an operator-provisioned legacy integration, not something automatically activated by normal website registration. Company credentials, wallets and credits are not interchangeable. Current Agent Tools documentation.

New no-account integration example: Fictional Flow invoice to reviewable CSV — no key, no upload or charges. Public EN sample gallery and DE examples. For actual authenticated processing use the maintained quickstarts below and obtain a quote before submitting.

Smithery links: Skavio Processing catalog profile identifies this server. The work-6dqn namespace gateway is a Smithery-managed MCP interface requiring Smithery authorization (connections:execute); its available connections depend on the authorized namespace. It is not the canonical Skavio Processing endpoint. Use https://getskavio.com/processing/mcp with company OAuth for direct connections. Anonymous checks on 2026-10-27 confirmed the gateway's HTTP 401 and Smithery OAuth metadata, but did not establish access to Skavio tools through it. Never send a Skavio company credential to the namespace gateway.

Discover Skavio MCP tools

Cursor / Claude Desktop / Claude Code setup: step-by-step remote MCP connections · ready-to-use Cursor JSON · optional Claude Desktop JSON. Also discover Skavio USDC micro-APIs and their MCP client guide.

Skavio remote MCP server — invoice OCR and extraction, PDF text extraction, document automation, image and media processing, transcription and meeting workflows for AI agents. Discover it in the official MCP Registry, or connect a compatible MCP client to https://getskavio.com/processing/mcp and complete OAuth, or use an explicitly issued company MCP bearer credential. Processing requires authentication.

• MCP setup and all available tools
• MCP pricing and prepaid company credits
• Official MCP server manifest · Smithery link roles and verification
• x402 paid USDC verification micro-APIs · machine-readable x402 discovery

The Processing MCP uses company-scoped prepaid credits; the separate x402 micro-APIs advertise payment-required responses. Neither requires exposing private keys to Skavio.

Card-funded prepaid processing: Processing MCP uses the authenticated company's Skavio wallet (1 USD = 1,000 credits). Only a company administrator funds the correct company wallet through the website checkout; an MCP agent cannot charge a card. The separate Agent Tools Dashboard offers Stripe-hosted $5–$500 card top-ups or USDC for its bound Agent Tools company wallet and eligible processing jobs paid with payment_mode=prepaid. Company credentials are NOT interchangeable. The four public blockchain-proof/DNS tools on https://getskavio.com/mcp and standalone x402 HTTP API calls remain native-USDC x402 only. Card funding and credit debit/refund logic passed controlled tests, but a real paid customer card-to-MCP completed-job E2E has not yet been independently verified.

One company-scoped API for document extraction, PDF and image tools, media processing, transcription and meetings.

• Product and pricing
• Live developer documentation
• Company workspace: register and create an API key
• OpenAPI v1 · Developer guide
• Python quickstart · Node.js quickstart · Bulk guide
• Postman public documentation · Collection
• DEV.to integration article
• Webhook verification

API route version: /v1. Contract snapshot: 1.9.0 + Pricing V2, captured 2026-10-04.

What is new in API 1.7.0

• Monthly charged/reserved usage and separate payment history, bounded CSV and key attribution.
• Atomic company/key budgets for API, batch, bulk and paid web admission.
• Expiring API keys with granular permissions and administrator-only policy writes.
• Queue visibility, persisted alerts, cancellation of unstarted standalone jobs and governance audit.
• Idempotent replay of failed job/batch/bulk webhook deliveries using the frozen original event.
• Structured errors and X-Request-Id correlation; Czech/German/English dashboard additions.

Read the Usage, budgets and recovery guide for authorization, UTC month rules, limits and compatibility.

Storage Fabric introduced in API 1.6.0

• Private S3 sources/results and compatible legacy local files.
• Verified direct uploads and resumable imports from approved customer cloud URLs.
• Company-scoped retention, archive, deletion hold and opt-in separate-bucket backups.
• Manual verified backup/restore, signed result downloads and encrypted import credentials.
• Existing Pricing V2, jobs, batches and bulk contracts remain supported.

Read the Storage Fabric guide for endpoints, production limits and browser upload handling.

Bulk features introduced in API 1.5.0

• Bulk manifests up to 100,000 items with immutable manifest pages of 1–100 items and bounded incremental child admission.
• Storage-aware admission through GET /v1/storage, declared input/output/scratch envelopes and durable storage reservations.
• Resume and failed-item retry for large workloads without resubmitting successful items.
• Crash/restart recovery for scheduler state, reservations, checkpoints and provider-intent reconciliation.
• Fair scheduling across companies while preserving the current ceiling of 4 active platform jobs globally.
• Existing 100-item batches remain available for simpler workloads.

Start with Bulk processing guide or the Python bulk quickstart. This repository contains the public developer kit. The hosted processing service requires a Skavio account and credits.

First result

1. Register, create a company profile and generate a read/write key in the company workspace. Copy it once and keep it server-side.
2. Upload a source using multipart field files.
3. Call POST /v1/estimate without starting processing.
4. Set max_credits to the returned estimated_credits.
5. Submit POST /v1/jobs with a stable Idempotency-Key.
6. Poll the returned job ID until completed or failed; download through the authenticated result paths.

The included invoice is synthetic, contains no customer data, and can be used for an extraction test.

Python 3.10+

python -m venv .venv

. .venv/bin/activate pip install -r requirements.txt

Set SKAVIO_API_KEY securely in your local environment.

export SKAVIO_IDEMPOTENCY_KEY="your-persisted-invoice-request-001" python quickstart.py

Node.js 22+

# Set SKAVIO_API_KEY securely in your local environment.

export SKAVIO_IDEMPOTENCY_KEY="your-persisted-invoice-request-002" node quickstart.mjs

Both examples use sample-invoice.txt; set SKAVIO_SOURCE to a PDF/image/text source to change it. They estimate cost before submission and write JSON output into results/. For intentional processing of a different source or changed payload, use a new idempotency key. These examples are server-side starters. For the official Python and JavaScript SDK clients, see sdk/README.md; durable workflow pipelines are documented in workflow-guide.md.

Postman

Import the collection or fork its public workspace copy. Set your own local/private environment variable api_key; never save a real key in the public collection. Set source_file to a local source. Run Upload → Estimate → Submit → Job status → Download. Poll every 3–10 seconds until the job is terminal before downloading. Requests cover the API-key processing endpoints; administration, key creation, billing and webhook registration use an interactive company administrator session in the dashboard. Before a new business request, clear upload_id, job_id, download_path, max_credits and idempotency_key in your private environment. Preserve the idempotency key when retrying the same submission.

What can I process?

Capabilities snapshot lists exact operation names. Query GET /v1/capabilities for current prices and limits. Normal file jobs accept one source; PDF merge accepts 2–20 PDFs; Flow can process multiple document sources. Transcribe and Meeting accept one media source. Batch processing supports up to 100 items. API 1.5.0 bulk manifests support up to 100,000 items with incremental dispatch; see bulk-guide.md. Standalone jobs do not support arbitrary operation chaining. Durable linear process/review/archive pipelines are available; see workflow guide.

Credits and price control

All web tools and API share a prepaid company wallet. No unlimited processing entitlement is advertised in this kit. The server measures bytes, pages and media duration. It reserves the quoted amount on submission, charges that fixed quote on success, and releases the reservation on failure. Use max_credits to reject unexpectedly expensive submissions and GET /v1/wallet to track balance and reservations.

**Current ba