Mistral Server

A comprehensive MCP (Model Context Protocol) server providing full access to the Mistral AI API. This server enables AI assistants like Claude to interact with all Mistral AI capabilities including chat completion, embeddings, fine-tuning, agents, OCR, audio transcription, and more.

Features

Chat & Completion

• Chat Completion - Full chat with function calling, JSON mode, vision support
• FIM Completion - Fill-in-the-middle code completion with Codestral
• Embeddings - Generate text embeddings for semantic search
• Agents Completion - Run completions with pre-configured agents

Model Management

• List all available models with capabilities
• Get detailed model information
• Delete fine-tuned models
• Update, archive, and unarchive fine-tuned models

File Management

• Upload files for fine-tuning, batch processing, or OCR
• List, download, and delete files
• Generate signed URLs for file access

Fine-Tuning

• Create fine-tuning jobs with customizable hyperparameters
• Monitor job status and progress
• Support for dry-run validation
• Cancel and start jobs

Batch Processing

• Create batch jobs for bulk API calls
• Monitor job progress and status
• Support for chat, embeddings, and FIM endpoints

Media Processing

• OCR - Extract text from documents and images
• Content Moderation - Check text and chat for safety issues
• Classification - Classify text with fine-tuned classifiers
• Audio Transcription - Transcribe audio with Voxtral

Agents & Conversations (Beta)

• Create and manage agents with custom instructions
• Manage conversations with agents
• Full conversation history support

Libraries (Beta)

• Create document libraries for RAG
• Upload and manage documents
• Share libraries with users and workspaces

Installation

# Clone the repository
git clone https://github.com/firstcastsolutions/mistral-mcp-server.git
cd mistral-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Set the required environment variable:

export MISTRAL_API_KEY="your-mistral-api-key"

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mistral": {
      "command": "node",
      "args": ["/path/to/mistral-mcp-server/dist/index.js"],
      "env": {
        "MISTRAL_API_KEY": "your-api-key"
      }
    }
  }
}

Standalone

export MISTRAL_API_KEY="your-api-key"
npm start

Available Tools (40+)

• Chat completion, FIM, embeddings, agents
• Model management (list, get, delete)
• File management (upload, download, delete)
• Fine-tuning jobs
• Batch processing
• OCR, moderation, classification
• Audio transcription
• Agents and conversations (Beta)
• Document libraries (Beta)

License

MIT - First Cast Solutions LLC