How to Use Mistral OCR document extraction in VS Code
Extracts page-by-page Markdown, tables, images, and document structure from PDFs and images. Use it to turn reports or scanned documents into readable content, with annotations when you need structured records.
Prompts to try with Mistral OCR document extraction in VS Code
Copy an example into VS Code, or ask in your own words.
Use Mistral OCR document extraction on https://arxiv.org/pdf/1706.03762 and save the page Markdown in this project's research directory.
Use Mistral OCR document extraction on https://arxiv.org/pdf/2201.04234 and build a CSV export of its extracted tables, preserving page references.
Use Mistral OCR document extraction on https://arxiv.org/pdf/2410.07073 and add its extracted figures and page locations to the project's document viewer.
Use Mistral OCR document extraction on https://arxiv.org/pdf/2302.13971 and create a heading index from the returned content blocks.
Use Mistral OCR document extraction on https://arxiv.org/pdf/1511.08771, split the PDF as needed for the documented limits, and assemble the results into one ordered Markdown document.
How to set up Mistral OCR document extraction in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Mistral OCR document extraction
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "mistral", "model": "mistral-ocr-latest", "input": { "document": { "document_url": "<document_url>" } } }'
Then paste one of the prompts above: VS Code finds Mistral OCR document extraction on Spiral, shows the price and runs it.
Mistral OCR document extraction providers and prices
Spiral runs Mistral OCR document extraction through Mistral. Open a card for today's price, with every fee included.
Settings you can ask for
Mistral OCR document extraction works from your document annotation prompt. Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Image limit | a whole number | Max images to extract | |
| Table format | markdown or html | ||
| Extract footer | on or off | off | Extract the page footer into the response's |
| Extract header | on or off | off | Extract the page header into the response's |
| Image min size | a whole number | Minimum height and width of image to extract | |
| Include blocks | on or off | on | Return paragraph-level bounding boxes for all content blocks in the response |
| Include image base64 | on or off | Include image URLs in response | |
| Confidence scores granularity | word, page, or block | Granularity for confidence scores: 'page' (aggregate only), 'word' (per-word scores), or 'block' (per-block scores). Defaults to None (no confidence scores) to keep response payload small. |
Every API field of Mistral OCR Latest is on its tool page: open its card above.
What can you do with Mistral OCR document extraction in VS Code?
Build a searchable document index from Mistral OCR's page text, tables, and images. Use paragraph bounding boxes to link search results back to the document regions they came from.
Make research papers searchable
Convert paper PDFs into Markdown and organize extracted sections by page for a research search index.
Compare tables across published reports
Extract tables from annual reports, then compare matching rows while retaining their source pages.
Turn equipment manuals into reference material
Extract manual text, tables, and diagrams so a support assistant can work from the supplied documentation.
Build a figure catalog
Collect extracted figures and their page locations, then request individual figure annotations for a browsable research catalog.
Prepare document review overlays
Use paragraph bounding boxes and structural labels to connect extracted content with the corresponding region of a document page.
Create structured report records
Use document annotations to extract selected titles, reporting periods, and other stated details into a consistent JSON structure.
Digitize multilingual publications
Extract text from English, French, German, and Spanish publications for a searchable archive that retains the original wording.
More on Mistral OCR document extraction and VS Code
Overview
Mistral OCR document extraction in other agents
Questions about Mistral OCR document extraction in VS Code
Can VS Code use Mistral OCR document extraction?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Mistral OCR document extraction like any built-in tool.
How much does Mistral OCR document extraction cost in VS Code?
$0.0052 per page ($0.0065 with document or bounding-box annotations). You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.
Do I need a Mistral account to use Mistral OCR document extraction in VS Code?
No. Spiral runs Mistral OCR document extraction on its own Mistral account. You sign in to Spiral once and never paste a key.
How long does it take to set up Mistral OCR document extraction in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while Mistral OCR document extraction runs?
Mistral OCR document extraction runs in the background. VS Code starts the run, checks on it and gives you the json when it's ready.
How large can a document be?
Mistral's chunking cookbook identifies limits of 50 MB and 1,000 pages. For larger documents, it recommends splitting the file, processing the pieces, and combining their results.
Which languages can Mistral OCR read?
The documented OCR language list includes English, French, German, Spanish, Portuguese, Italian, Dutch, Polish, and Czech. Coverage extends beyond English-language documents.
Does document-level annotation inspect every extracted image?
It receives the OCR Markdown plus the first eight extracted image bounding boxes. For figure-heavy documents, use annotations on individual extracted figures when you need descriptions beyond that boundary.
Does the latest OCR model stay fixed?
The latest alias can change: Mistral's changelog currently points it to OCR 4.1. The OCR response also identifies which model produced the extraction.
How can I check recognition quality?
OCR 4.1 supports paragraph locations, structural labels, and block-level confidence scores, which can help target a review. Mistral also acknowledges that generated output can be inaccurate.
Start using Mistral OCR document extraction in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


