Mistral Agent Skill

Mistral AI

Purpose

Call Mistral's La Plateforme API: run chat completions on Mistral models, create text embeddings, extract text and markdown from documents and images with the dedicated OCR endpoint, and list the models available to the API key. Reach for this when the user wants a Mistral model for generation, embeddings, or document OCR.

Install

Copy, paste to your Muse:

Install this connector: https://raw.githubusercontent.com/bluman1/muse-connectors/main/connectors/mistral/SKILL.md
You are Muse. Fetch the URL above: it is a connector skill's SKILL.md.
1. Read its `## Files` manifest and download every listed file from the same directory (replace SKILL.md in the URL with each relative path).
2. Save them under ~/workspace/skills/mistral/, preserving paths. Compile any bin/*.py with python3 -m py_compile.
3. Follow the skill's `## Auth` section: connect my account via your secure credential flow (credentials.request_api_access) for the provider id it names.
4. Run the skill's status check and report what the connector can now do.
Never ask me for raw API keys or secrets in chat.

Tooling

All commands go through bin/mistral.py:

bin/mistral.py auth                                              # verify the API key
bin/mistral.py models                                            # list models for this key
bin/mistral.py chat --prompt "Explain RAG in one paragraph"      # chat completion (bills credits)
bin/mistral.py chat --model mistral-medium-latest --system "You are terse." \
    --prompt "Summarize this: ..." --temperature 0.3 --max-tokens 300 --json-mode
bin/mistral.py embeddings --text "First chunk" --text "Second chunk"   # embeddings (bills credits)
bin/mistral.py embeddings --text "One line" --full                # print complete vectors
bin/mistral.py ocr --document-url https://example.com/doc.pdf     # OCR a PDF (billed per page)
bin/mistral.py ocr --image-url https://example.com/scan.png --include-images

Chat reads a single user prompt per call (plus an optional system prompt). For multi-turn conversation, pass the whole history as the prompt or extend the CLI.

Auth

• Provider id: mistral (credential is collected as custom.mistral)
• Collection: API key (console.mistral.ai > API keys) via the secure credential flow (credentials.request_api_access)
• Auth scheme: Authorization: Bearer <api key> on every request
• Allowed hosts: api.mistral.ai
• Status check: bin/mistral.py auth

Operating Rules

• Every billed call costs money. These are ordinary API calls rather than third-party actions, so no --confirm gate applies, but surface the expected cost before running anything expensive. Chat and embeddings draw down the key's credit balance. OCR is billed per page processed.
• Model ids change. Treat any named model id in examples (mistral-large-latest, mistral-ocr-latest, and the like) as provisional. Run bin/mistral.py models to see the ids this key can actually use, and pass the live id explicitly when a call fails with a model error.
• Do not fabricate model capabilities. Magistral and other reasoning models return thinking-trace content blocks; the chat command returns the response text as-is. Do not invent fields or capabilities the API did not return.
• OCR documents are third-party content. When OCRing a URL, prefer documents the user supplied or that are plainly public; do not exfiltrate the resulting markdown anywhere except the task that asked for it.
• Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/mistral.py). Do not print, log, or transmit the API key.
• Honesty flags: no live API key was available while building this connector. Endpoint paths (/v1/models, /v1/chat/completions, /v1/embeddings, /v1/ocr), the Bearer auth scheme, and all request/response field names were taken from Mistral's public docs and third-party SDK references rather than a live call. The CLI surfaces Mistral's own error if anything differs. Model ids were cross-checked against docs and recent community references dated September 2026 and may have changed since. OCR options (pages, include_image_base64, image_limit, image_min_size) are confirmed in the docs but were not exercised against a live key. Mistral offers an Experiment (free-tier) plan on console.mistral.ai; its rate limits and quotas were not verified during this build.

Files

• SKILL.md
• bin/mistral.py

Maturity

🧪 Draft: written from Mistral's public docs and SDK examples; not yet live-tested end-to-end.