mistral-mcp

mistral-mcp

MCP server for Mistral AI — chat, OCR, audio (Voxtral), code (Codestral), vision, agents, batch, and durable workflows. Plug into Claude Code, Cursor, Zed, Windsurf, or Claude Desktop in one command.

Version française : README.fr.md

---

What this is

mistral-mcp exposes the full Mistral AI API as a set of MCP tools, resources, and prompts. An MCP client (Claude Code, Cursor, etc.) can call mistral_ocr to extract text from a PDF, voxtral_transcribe to transcribe a meeting recording, or workflow_execute to start a durable multi-step process — all without leaving the agent loop.

Unique to Mistral and not available from other MCP servers:

• mistral_ocr — Mistral Document AI: structured text + bbox annotations from any PDF or image
• voxtral_transcribe — Voxtral: transcription with optional speaker diarization
• codestral_fim — Codestral fill-in-the-middle (FIM) for inline code completion
• workflow_execute / status / interact — Temporal-backed durable execution with human-in-the-loop signals
• French-optimized models (mistral-large-latest, mistral-medium-latest) and curated French prompts

What this server does not expose: fine-tuning, user management, non-FR/EN prompts.

---

Quick start

Claude Code (recommended — auto-installs, prompts for API key, ships 11 skills):

/plugin install mistral-mcp@swih-plugins

Cursor / Zed / Windsurf / Claude Desktop — add to your MCP settings JSON:

{
  "mcpServers": {
    "mistral": {
      "command": "npx",
      "args": ["-y", "mistral-mcp@latest"],
      "env": { "MISTRAL_API_KEY": "your_key_here" }
    }
  }
}

Manual Claude Code registration:

claude mcp add mistral -- npx -y mistral-mcp@latest

---

Profiles

MISTRAL_MCP_PROFILE controls how many tools are exposed (default: core).

Profile	Tools	Use when
core (default)	8	Daily use — lean context footprint
full	25	Need embeddings, streaming, batch, classify, files, agents, TTS
workflows	3	Pipeline orchestration only

MISTRAL_MCP_PROFILE=full npx mistral-mcp

---

Tools

Core profile (8 tools — always available)

Tool	What it does
mistral_chat	Chat completion. Supports all Mistral models, response_format, reasoning_effort for Magistral.
mistral_vision	Multimodal chat with images (URL or base64).
mistral_ocr	Document AI — extract text, bbox, and JSON annotations from PDFs/images.
codestral_fim	Fill-in-the-middle code completion (Codestral model).
voxtral_transcribe	Audio → text. Pass diarize: true for speaker separation.
workflow_execute	Start a Mistral Workflow (Temporal-backed durable execution).
workflow_status	Poll a running workflow — returns RUNNING | COMPLETED | FAILED | ....
workflow_interact	Signal / query a running workflow. Used for human-in-the-loop checkpoints.

Full profile only (+17 tools, set MISTRAL_MCP_PROFILE=full)

Group	Tools
Generation	mistral_chat_stream, mistral_embed, mistral_tool_call
Agents	mistral_agent, mistral_moderate, mistral_classify
Audio	voxtral_speak (TTS)
Files	files_upload, files_list, files_get, files_delete, files_signed_url
Batch	batch_create, batch_get, batch_list, batch_cancel
Sampling	mcp_sample (delegates generation to the MCP client's own model)

---

Resources

URI	What it returns
mistral://models	Live model catalog + accepted aliases
mistral://voices	Live Voxtral TTS voice catalog
mistral://workflows	Live list of deployed workflows (use name as workflowIdentifier)

---

Prompts

Curated prompts with structured arguments and MCP completion support:

Prompt	Input	Output
french_meeting_minutes	transcript text	Structured French meeting minutes
french_email_reply	received email + context	Polished French reply
french_commit_message	git diff	Conventional Commits message in French
french_legal_summary	legal document text	Plain-French summary + key clauses
french_invoice_reminder	debtor, amount, days overdue, tone	B2B dunning letter in French
codestral_review	git diff	Focused code review (security / logic / style)

---