vibe-mistral-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
vibe-mistral-mcp
One MCP stdio server with both halves of Mistral in it:
Vibe agent — delegate coding work to Mistral Vibe through ACP (
vibe-acp).Studio lookups — a five-tool slice of Mistral's Studio MCP server (
https://api.mistral.ai/mcp): budgets, docs search, Skills catalogue.
They are one process and one configuration entry because they share nothing but the
provider: the Vibe half talks ACP to a local agent (model inference on the Vibe plan), the
Studio half talks Streamable HTTP to api.mistral.ai (workspace metadata). Merging them
keeps a single mount, a single repo and a single place to see failures — without pretending
one replaces the other.
Mistral Vibe's subscription credential created by vibe-acp --setup is a chat-plan
credential, not an api.mistral.ai API key, so it cannot back an OpenAI-compatible
provider route. What it can back is an ACP agent: this bridge speaks MCP to the harness
and ACP v1 (agentclientprotocol.com) to vibe-acp.exe,
so a model can hand a self-contained task to Mistral Large 4 (or another Mistral-hosted
model) running with Vibe's own file and shell tools.
Stdlib only, three Python modules (vibe_mcp.py, studio.py, vibe_doctor.py) and one
ES module for the harness command (dsh/vibe-command.mjs), no dependencies.
This project talks to tools you already own and are signed in to: it never holds a credential. The Mistral API key is read from
MISTRAL_API_KEYor from the harness credential store; the Vibe plan credential lives invibe-acpitself.
Tools
Vibe agent (ACP):
Tool | Purpose |
| Start a task in the background; returns a |
| Check a job ( |
| List recent jobs (state, elapsed, model, cwd) |
| Blocking call, kept for quick checks |
| Models, thinking levels and approval modes Vibe offers |
| Cancel a running prompt, otherwise close the ACP session/process |
| Health in one call: process, session, prompt idleness, job counts, Studio reachability |
Studio workspace (whitelisted slice of api.mistral.ai/mcp, 5 of its 133 tools — mounting
it whole would add every schema to every request):
Tool | Upstream | Purpose |
|
| plan, API and Vibe Code budgets, remaining credit |
|
| search docs.mistral.ai |
|
| one documentation page as Markdown |
|
| the workspace Skill catalogue |
|
| one Skill, including its files |
A Vibe job keeps running in the bridge process while the caller does other work; the last 20 jobs are retained. Jobs are serialized because ACP allows one prompt per session. Studio calls are independent of the Vibe session and answer while a prompt is running.
Related MCP server: Claude Code Subagent MCP
Requirements
Python 3.9+ (the bridge and the doctor are stdlib only).
Mistral Vibe installed and signed in (
vibe-acp --setup). The bridge looks forvibe-acponPATHfirst, then in the usual install locations of each platform, and never handles that credential.Linux and Windows are both exercised: the suite runs on CachyOS (Python 3.14) and on Windows (3.12), and
dsh/vibe-command.mjsneeds Node only for the/vibecommand.
Configuration
Run it with any Python 3.9+ interpreter. Environment:
Variable | Default | Meaning |
|
| ACP agent executable, or a command with arguments |
| user home | Default working directory |
| (unset: Vibe's own choice) | Model applied when a call omits one, using the inference-API id |
|
| Thinking level applied when omitted |
|
| Approval mode applied when omitted |
|
| Default/maximum seconds per prompt |
|
| Cancel a prompt that emits no ACP update for this long |
|
| Silence budget while a tool call is in flight |
|
| Seconds to wait for a cancel to settle before killing the process |
|
| Bearer token for the Studio half |
|
| Studio MCP endpoint |
|
| Studio request timeout in seconds |
|
| Seconds before a failed Studio connection is retried |
The Studio key is read from MISTRAL_API_KEY when set, otherwise from the harness
credential store. Reading the store matters under DeepSeek Harness: its MCP client scrubs
environment names matching KEY|TOKEN|PASSWORD|SECRET, so an exported MISTRAL_API_KEY
never reaches this child process.
Leave VIBE_ACP_MODEL unset unless you know your account serves the model: asking for a
model the plan does not include makes Vibe fall back to another one silently, and the
fallback rejects thinking levels the first model accepted. The bridge clamps the level to
what the selected model offers and reports the substitution, but letting Vibe choose avoids
the mismatch altogether.
Model and thinking levels belong to the account
Vibe decides which models exist and which thinking levels each one accepts; the inference
API has the final word and rejects anything else with a 400 that fails the whole prompt.
vibe_options reports both live.
A model id is the one the inference API publishes, not the label in the picker. Vibe's
built-in catalogue ships a stale id for Mistral Large 4 (mistral-large-4-0-3); the API
answers 400 Invalid model for it and the agent then serves a different model without
saying so — the prompt succeeds, the answer is not from the model you picked. The docs list
mistral-large-4 and mistral-large-4-0. Define the preset yourself so the correct id is
what gets sent:
allowed_models = ["mistral-large-4", "mistral-medium-3.5", "zai-glm-5-3", "zai-glm-5-3-flash"]
active_model = "mistral-large-4"
[[models]]
name = "mistral-large-4" # the id the inference API accepts
provider = "mistral"
alias = "mistral-large-4"
thinking_levels = ["low", "medium", "high"]
max_context_length = 1048576
supports_images = trueallowed_models matters: it filters what the picker offers, matched against the names sent
to the API, so listing only the ids you configured also hides the broken built-in entry.
The bridge does not hide this. It reports the model the session actually selected, clamps a
thinking level the selected model does not offer, and tests/probe_served_model.py compares
that report against Vibe's own log, which is where the silent substitution is recorded.
Example DSH profile patch (cordis.patch.yml):
- insert:
- id: mcp-vibe
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: vibe
transport: stdio
command: C:\path\to\python.exe
args:
- C:\path\to\vibe_mcp.py
env:
VIBE_ACP_EXE: C:\Users\you\AppData\Local\Microsoft\WinGet\Links\vibe-acp.exe
VIBE_ACP_MODEL: mistral-large-4-0-3
VIBE_ACP_THINKING: high
VIBE_ACP_MODE: accept-edits
toolCallTimeoutMs: 2147483646 # Node setTimeout ceiling; default 60 s is far too lowReaching the ACP protocol version: initialize (protocolVersion 1), session/new
(cwd + MCP servers), session/set_config_option (model/thinking/mode), session/prompt,
session/cancel; output is read from session/update notifications
(agent_message_chunk, tool_call, tool_call_update).
Notes
vibe-acpmust already be signed in (vibe-acp --setup); this bridge never handles the token.Tool-permission requests from Vibe are answered with the single-call allow option when there is one; a persistent
allow_alwaysgrant is only used when it is the only allow option, so Vibe edits files and runs commands in the givencwdwithout a standing grant.A prompt that times out is cancelled rather than left running unattended; a dead
vibe-acpprocess is restarted once and the prompt replayed.A wedged prompt cannot block the bridge forever. Prompts are serialized, so a silent hang used to queue every later job indefinitely. Now a prompt that sends no
session/updateforVIBE_ACP_IDLE_TIMEOUTis cancelled; ifsession/canceldoes not settle withinVIBE_ACP_CANCEL_GRACE,vibe-acpis killed and the job fails with a clear reason.vibe_resetcancels queued jobs and escalates the same way.Job state is
queueduntil it actually owns the prompt slot, thenrunning;vibe_pollreports how long the running prompt has been silent and what it last touched.One prompt at a time, and that is visible.
vibe_promptrefuses while another prompt owns the slot instead of blocking for hours behind the harness' ~24-day tool timeout; usevibe_start+vibe_pollfor background work.A cancelled prompt leaves its ACP session unusable, so the next prompt gets a fresh process instead of inheriting the cancellation. The same happens when the working directory changes.
The process reader is generation-stamped: a reader of a replaced process can no longer mark the live one as dead, which used to break delegation right after a restart.
Mistral may answer
Model 'X' is not available — running 'Y'after a model selection: Vibe falls back silently, and a thinking level the fallback does not accept surfaces as a 400 from the prompt. Keepthinking: high, which both Mistral Large 4 and Medium 3.5 accept.The Studio schemas are fetched in the background, so
tools/listanswers immediately even whenapi.mistral.aiis unreachable — the Vibe tools stay available either way. A failed Studio connection is retried afterMISTRAL_STUDIO_RETRY_COOLDOWNseconds.Chunk accumulation, cancellation and job state are kept in memory; restarting the bridge drops unfinished jobs.
The /vibe command
dsh/vibe-command.mjs registers a /vibe slash command in the DeepSeek Harness chat.
It runs vibe_doctor.py, which starts a fresh vibe-acp, negotiates ACP, opens a
session and runs one real prompt, then checks the Studio half and the remaining plan
budget. The answer therefore comes from the agent itself, not from a cached flag.
/vibe full check, one live prompt
/vibe quick skip the prompt (spends no plan tokens)Enable it in the profile patch:
- id: vibe-command
name: "file:///C:/path/to/vibe-mistral-mcp/dsh/vibe-command.mjs"
config:
doctor: C:\path\to\vibe-mistral-mcp\vibe_doctor.py
python: C:\path\to\python.exe
timeoutMs: 240000
traceFile: C:\path\to\vibe-mistral-mcp\vibe-command.log # optionalThe doctor also runs on its own:
python vibe_doctor.py # full check
python vibe_doctor.py --quick # no live prompt
python vibe_doctor.py --json # machine-readableIt exits 0 when every check passed.
Tests
tests/regress.py drives the server over MCP stdio exactly like the harness does and
checks the concurrency and failure paths (cold start, process restart, a prompt running
while other tools are called, cancel and restart, unreachable Studio upstream):
python tests/regress.pyIt needs no Mistral account: tests/fake_vibe_acp.py is an ACP stub that answers like the
agent, including a cancel that interrupts a long tool run, so the suite is hermetic and
runs on any machine:
VIBE_TEST_ACP_EXE="python3 tests/fake_vibe_acp.py" python3 tests/regress.pyThe interpreter, the server path and the scratch directory come from the environment
(VIBE_TEST_PYTHON, VIBE_TEST_SERVER, VIBE_TEST_WORK), so no path is hardcoded.
Against a real account, these probes answer "what does my plan actually serve?":
Probe | Question |
| which models are selectable, and does one silently fall back to another |
| did the model I selected really answer, or did Vibe substitute one |
| which inference-API id for Large 4 the API actually accepts |
| which thinking levels each model really accepts |
| does the bridge substitute an unsupported level instead of failing |
| how the ACP executable is located on this platform |
They spend plan tokens, unlike the hermetic suite.
Contributing
Small, focused pull requests are welcome. python tests/regress.py must pass, and a new
behaviour needs a check in it. Please do not commit local paths, credentials or anything
that names a private host.
License
Dual license, at your option — see LICENSE:
MIT (LICENSE-MIT) or
Apache License 2.0 (LICENSE-APACHE-2.0).
Both options are complete and free on their own terms: no purchase, no approval, no paperwork. Apache-2.0 is the better fit for corporate redistribution — besides the broad copyright license, it grants a patent license (section 3) that terminates if you initiate patent litigation against the copyright holder; MIT is the more permissive of the two, with no express patent grant and no NOTICE file.
Support, warranties and indemnification are not granted by either license. They are a separate agreement with the copyright holder, not a third license option.
The names of the upstream projects this project talks to (Mistral, Vibe, DeepSeek Harness, ACP) belong to their owners and are used only descriptively.
Security
See SECURITY.md. The project holds no credentials of its own.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
Related MCP Servers
AlicenseAqualityDmaintenanceStdio bridge for editors to connect to the GenieOS MCP server, enabling AI agents to interact with GenieOS via Streamable HTTP transport.647 npmMIT- AlicenseAqualityCmaintenanceA stdio MCP server that lets Codex Desktop/CLI delegate implementation tasks to Claude Code CLI with workspace validation, Git status checks, and session resume capabilities.24MIT
- FlicenseNot gradedqualityCmaintenanceEnables integrating an AI-powered agile squad with MCP-compatible clients like Antigravity, Claude Desktop, and Cursor over Stdio or SSE.-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to access hosted models and services via a local stdio bridge, with live model discovery, pricing, balance checks, and paid execution requiring cost estimates.MIT