Skip to the page
Get started free

Mistral Vibe

Add SpecStream to Mistral Vibe with one vibe mcp add command. Vibe's coding agent can then search the live web, read pages and ask for structured rows, and SpecStream shows the price before any paid run.

SpecStream for Mistral VibeCoding agents

What you need

  • Mistral Vibe, installed with Mistral's install script or uv tool install mistral-vibe.
  • A SpecStream account. New accounts start with $10 of credit, no card. Create one.

  1. 1. Add the server

    Run this in a terminal. vibe mcp add writes the server to your user config.toml, which is ~/.vibe/config.toml, without starting a session. The transport defaults to streamable-http, the one SpecStream serves at https://api.specstream.ai/mcp.

    Terminal
    vibe mcp add specstream --url https://api.specstream.ai/mcp

  2. 2. Sign in to SpecStream

    The command has no --header or --api-key-env, so Vibe treats SpecStream as an OAuth server and starts the sign-in at once. Approve the access in the browser window. Vibe registers itself with SpecStream, so there is no client ID to enter, and it keeps the tokens in your OS keyring, not in config.toml.

    On a remote machine over SSH, forward the callback port before you sign in: ssh -L 47823:127.0.0.1:47823 <host>. If you skipped the sign-in, run /mcp login specstream in a session.

  3. 3. Check the tools

    Start vibe in your project. /mcp specstream lists SpecStream's tools, and /mcp status shows that the server is signed in.

  4. 4. Ask Vibe

    Ask for something the code needs from the web:

    In a Vibe session
    Find the latest FastAPI release and its changelog, then update the pin in requirements.txt.

Or add it in config.toml

Append this table to ~/.vibe/config.toml, or to a project's .vibe/config.toml, then run /mcp login specstream in a session. An empty scopes list accepts SpecStream's default access.

Use an API key instead

Use a key where Vibe has no OS keyring to hold OAuth tokens, such as CI. In SpecStream, open Agents & API, choose API keys, then Create API key, and set a spending limit. Export it as SPECSTREAM_API_KEY, then add the server with --api-key-env. Vibe sends it as Authorization: Bearer <key> by default, the form SpecStream reads:

vibe mcp add specstream --url https://api.specstream.ai/mcp --api-key-env SPECSTREAM_API_KEY

The tools Vibe gets

Vibe names each MCP tool with the server's name in front, so SpecStream's tools arrive as:

  • specstream_search_web answers a question from the live web with the Search API, with the results and their pages, at $5 per 1,000 searches of up to 10 results.
  • specstream_read_pages returns the main text of up to 20 pages or documents (PDF, Word, Excel) a call with the Extract API, at $0.80 per 1,000 pages. A page with no text is not charged.
  • specstream_compile, specstream_quote_capacity_work and specstream_authorize_capacity_work run Deep Search: every match on the live web as structured rows, priced before it starts.

Approvals in Vibe

Searches and page reads need no quote, so you can let them run. Keep the tool that starts a paid Deep Search run on ask. SpecStream adds its own gate: nothing paid begins until you approve the maximum it quotes.

Vibe's own web_search and SpecStream

Vibe's built-in web_search asks a Mistral model and returns an answer with its cited sources, on your Mistral API key. SpecStream's search_web returns the results it read with each page's URL, title and snippet, read_pages returns the full text of the pages the agent picks, and Deep Search returns many matches as rows. Each value carries the URL of the page it was read on and the time it was read.

Cost

Connecting SpecStream to Vibe is free. Reading a request and pricing it cost nothing. A Deep Search row costs 5¢, 15¢ or $1, depending on what the row needs, plus 5¢ for a person's email and 15¢ for a phone. A run never costs more than the maximum you approved, and a run that finds nothing costs nothing. Balance, quotes, and billing has the details.

Remove SpecStream

vibe mcp remove specstream removes the server and deletes its stored tokens. To end its access on the SpecStream side, open Agents & API, choose OAuth applications, and revoke Vibe, or revoke the key under API keys. Questions: [email protected].

More

SpecStream for Mistral Vibe covers what it does in Mistral Vibe on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and the matches are paid from your balance. Billing has the details. For help, email [email protected].