Skip to content
Agent Guides

Mistral Agents API

Mistral’s hosted Agents API. Launched May 2025 — server-managed agents with built-in connectors (web search, code interpreter, document QA), MCP support, and multi-agent orchestration. Think OpenAI Assistants but for Mistral models.

Install

Terminal window
pip install mistralai

Version

mistralai 2.4.4 · May 2026 · Python 3.10+

Best for

Mistral-native workloads, hosted agents with connectors, MCP-heavy flows.

Zero → Hero

Section titled “Zero → Hero”
1 · Agent lifecycle Create, invoke, converse, destroy · 15 min
2 · Conversation flow Messages, threads, history · 15 min
3 · Multi-agent orchestration Supervisor, specialist routing · 25 min
4 · Tool execution Function calling, validation · 20 min
5 · Connectors Web search, code interp, doc QA · 20 min
6 · MCP integration MCP client + server patterns · 20 min
7 · Memory & state Threads, persistence · 15 min
8 · Request/response pipeline Under the hood · 15 min
9 · Advanced Python patterns Async, batching, error handling · 20 min
10 · Streaming (FastAPI) SSE streaming server · 20 min
11 · Production Deployment, monitoring · 25 min

Jump to a topic

Section titled “Jump to a topic”
Agent lifecycle
Conversation flow
Multi-agent orchestration
Connectors
MCP
Tool execution workflow
Memory architecture
Agent configuration schema
Advanced Python
May 2025 launch updates

Reference

Section titled “Reference”
Comprehensive guide Single-page technical reference + diagrams.
Connectors guide Built-in connectors.
Orchestration guide Multi-agent patterns.
MCP guide
Advanced Python
Recipes
Diagrams
Production guide
Streaming server (FastAPI)
May 2025 launch updates

What’s new in v2.4.4 (May 2026)

Section titled “What’s new in v2.4.4 (May 2026)”
  • v2.4.4 (May 1) — Patch release; stability improvements.
  • v2.4.3 (April 28) — Patch release; stability improvements.
  • v2 SDK with refined async patterns.
  • Connectors — web search, code interpreter, document QA.
  • MCP client and server support.
  • Orchestration — multi-agent coordination patterns.

Install, minimal example

Section titled “Install, minimal example”
import os
from mistralai.client import Mistral   # import from mistralai.client, NOT from mistralai


client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])


agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Assistant",
    instructions="You are a helpful assistant.",
)


conversation = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="What is 15 + 27?",
)
print(conversation.outputs[0].content)

Ready? Start Zero → Hero Step 1 →

Revision history

Section titled “Revision history”
DateVersionChangesReviewer
2026-05-01mistralai 2.4.4Version bumped 2.4.3 → 2.4.4 (patch release); version card and “What’s new” updated; from mistralai.client import Mistral verified against installed 2.4.4 (.routine-envs/check-mistral2-0501).Claude routine
2026-04-28mistralai 2.4.3Version bumped 2.4.2 → 2.4.3 (patch release); version card and “What’s new” updated; from mistralai.client import Mistral verified against installed 2.4.3.Claude routine
2026-04-24mistralai 2.4.2Version bumped 2.4.1 → 2.4.2 (patch release April 23); version card and “What’s new” updated.—
2026-04-21mistralai 2.4.1Index redesigned with Zero → Hero + Jump-to-topic grid.—
April 2026mistralai 2.4.1v2 SDK stabilised; connectors; MCP; orchestration.—
May 2025LaunchAgents API public launch.—