> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Serveur Venice MCP
> Le serveur officiel Venice MCP expose 31 outils Venice — chat, images, vidéos, audio, musique, personnages — dans n'importe quel hôte MCP.
Le [serveur Venice MCP](https://github.com/veniceai/venice-mcp-server) est le serveur officiel [Model Context Protocol](https://modelcontextprotocol.io/) pour Venice. Il expose l'intégralité de l'API Venice (chat, image, vidéo, audio, musique, embeddings, web augment et personnages) sous la forme de **31 outils** que tout agent compatible MCP peut appeler.
Publié sous le nom [`@veniceai/mcp-server`](https://www.npmjs.com/package/@veniceai/mcp-server) sur npm. Licence MIT.
Toutes les modalités Venice dans un seul bloc de configuration
Claude Desktop, Cursor, ChatGPT, LM Studio, Continue, et plus encore
Apportez une clé API, ou payez à l'appel avec un wallet signé via SIWE et x402
## Démarrage rapide
Générez-en une depuis [venice.ai/settings/api](https://venice.ai/settings/api). Consultez le [guide des clés API](/guides/getting-started/generating-api-key) pour des instructions détaillées.
Insérez ceci dans le fichier de configuration de votre hôte MCP :
```json theme={"system"}
{
"mcpServers": {
"venice": {
"command": "npx",
"args": ["-y", "@veniceai/mcp-server@0.2.0"],
"env": { "VENICE_API_KEY": "" }
}
}
}
```
Chemins de configuration courants :
| Hôte | Chemin |
| ------------------------ | ----------------------------------------------------------------- |
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Cursor | `~/.cursor/mcp.json` |
| LM Studio | `mcp.json` (depuis les paramètres MCP de l'application) |
Votre agent dispose désormais des outils chat, image, vidéo, musique, TTS, ASR, et de 25 autres outils Venice.
La plupart des hôtes MCP ne transmettent que les variables d'environnement **explicitement listées** dans le bloc `env`. Les variables d'environnement système ne sont pas héritées. Si vous voyez des erreurs 402 alors qu'une clé API est définie, vérifiez que `VENICE_API_KEY` se trouve bien dans `env` dans votre configuration.
## Ce que vous obtenez
**31 outils** couvrant chaque modalité Venice, **3 ressources** (`venice://models`, `venice://styles`, `venice://voices`) et **3 modèles de prompts**.
### Chat et embeddings
| Outil | Description |
| ---------------------------- | ----------------------------------------------------------------------------------------- |
| `venice_chat` | Chat completion compatible OpenAI sur l'ensemble du catalogue LLM de Venice. |
| `venice_responses` | API Responses compatible OpenAI avec prise en charge des outils en un ou plusieurs tours. |
| `venice_embeddings` | Calcule les embeddings pour un texte d'entrée. |
| `venice_chat_with_character` | Discutez avec un personnage Venice via son slug. |
### Image
| Outil | Description |
| ------------------------- | ----------------------------------------------------------------------------------------------------- |
| `venice_image_generate` | Générez une image (Flux 2, Lustify SDXL, Anime/WAI, Qwen Image, GPT Image, Nano Banana Pro, et plus). |
| `venice_image_edit` | Modifiez une image à partir d'un prompt. |
| `venice_image_multi_edit` | Modifiez plusieurs images ensemble avec un même prompt. |
| `venice_image_upscale` | Mettez à l'échelle une image jusqu'à 4×. |
| `venice_image_remove_bg` | Supprimez l'arrière-plan d'une image. |
| `venice_image_styles` | Listez les presets de style d'image. |
### Vidéo
| Outil | Description |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `venice_video_generate` | Mettez en file d'attente une génération vidéo (Sora 2, Veo 3.1, Kling, Wan, LTX 2, Seedance, Runway Gen-4, et plus). |
| `venice_video_status` | Vérifiez l'état d'une tâche vidéo en file d'attente. |
| `venice_video_complete` | Marquez une vidéo terminée comme téléchargée ; supprime le média côté serveur. |
| `venice_video_transcriptions` | Transcrivez l'URL d'une vidéo YouTube. |
| `venice_video_quote` | Obtenez un devis avant la mise en file d'attente. |
### Audio (TTS / ASR)
| Outil | Description |
| -------------------- | ----------------------------------------------------------------------- |
| `venice_tts` | Synthèse vocale avec voix clonées et balises d'émotion. |
| `venice_asr` | Transcrivez de l'audio depuis une URL. |
| `venice_voice_clone` | Listez les voix intégrées ou clonez une voix à partir d'un échantillon. |
| `venice_audio_quote` | Obtenez un devis pour la génération musicale. |
### Musique
| Outil | Description |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `venice_music_generate` | Mettez en file d'attente une génération musicale (`ace-step-15`, `elevenlabs-music`, `minimax-music-v2/v25/v26`, `stable-audio-25`, `mmaudio-v2`, `elevenlabs-sound-effects-v2`). |
| `venice_music_status` | Vérifiez l'état d'une tâche musicale en file d'attente. |
| `venice_music_complete` | Marquez une tâche musicale terminée comme téléchargée. |
### Web augment, catalogue et crypto
| Outil | Description |
| ------------------------ | -------------------------------------------------------------------------------------------- |
| `venice_web_search` | Recherchez sur le web (basé sur Firecrawl). |
| `venice_web_scrape` | Scrapez une URL en markdown. |
| `venice_text_parser` | Extrayez le texte de PDF/DOCX/EPUB/PPTX/XLSX. |
| `venice_list_models` | Listez le catalogue de modèles en direct avec les prix. |
| `venice_list_characters` | Listez les personnages Venice publics. |
| `venice_crypto_rpc` | Servez de proxy pour des appels JSON-RPC vers Base, Ethereum, Polygon, Arbitrum ou Optimism. |
### Helpers wallet x402
Pertinent uniquement si vous vous authentifiez avec un wallet via [x402](/guides/integrations/x402-venice-api) au lieu d'une clé API.
| Outil | Description |
| -------------------------- | -------------------------------------------------------------------------------------- |
| `venice_x402_balance` | Vérifiez le solde de crédit prépayé x402 pour une adresse de wallet EVM ou Solana. |
| `venice_x402_top_up_info` | Récupérez les exigences de top-up (réseau, token USDC, destinataire, montant minimum). |
| `venice_x402_transactions` | Listez les top-ups et débits x402 récents pour une adresse de wallet EVM ou Solana. |
## Configuration
Le serveur se configure entièrement via des variables d'environnement.
| Variable d'env. | Défaut | Notes |
| ---------------------------- | ------------------------- | ---------------------------------------------------------------------------------------- |
| `VENICE_API_KEY` | *(aucun)* | Votre clé API Venice. La configuration la plus simple. |
| `VENICE_DEFAULT_CHAT_MODEL` | `venice-uncensored` | |
| `VENICE_DEFAULT_IMAGE_MODEL` | `flux-2-pro` | |
| `VENICE_DEFAULT_TTS_MODEL` | `tts-kokoro` | |
| `VENICE_DEFAULT_ASR_MODEL` | `openai/whisper-large-v3` | |
| `VENICE_DISABLE_NSFW` | `0` | Définissez à `1` pour retirer les mentions de capacité NSFW des descriptions d'outils. |
| `VENICE_HTTP_TIMEOUT_MS` | `60000` | |
| `VENICE_SIWX_TOKEN` | *(aucun)* | Token d'authentification en mode wallet x402. Voir [x402 ci-dessous](#x402-wallet-mode). |
Si `VENICE_API_KEY` et `VENICE_SIWX_TOKEN` sont tous deux définis, la clé API prime.
## Mode wallet x402
Venice prend en charge l'authentification avec un [token wallet Sign-In-With-X](/guides/integrations/x402-venice-api) adossé à du crédit USDC prépayé sur Base ou Solana, en plus du flux classique par clé API. Pas d'e-mail, ni de téléphone, ni de KYC requis : votre wallet est votre seule identité.
```json theme={"system"}
{
"mcpServers": {
"venice": {
"command": "npx",
"args": ["-y", "@veniceai/mcp-server@0.2.0"],
"env": { "VENICE_SIWX_TOKEN": "" }
}
}
}
```
Le serveur MCP transmet `VENICE_SIWX_TOKEN` dans l'en-tête `X-Sign-In-With-X` à chaque appel de l'API Venice. Le serveur ne voit jamais votre clé privée. La signature du wallet et les autorisations de top-up USDC se produisent dans votre propre wallet.
| Flux | Ce qui se passe |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Configuration unique** | Signez un message Sign-In-With-X dans votre wallet → produit un token SIWX (JSON base64). |
| **Top-up** | `POST /api/v1/x402/top-up` renvoie 402 + des exigences de paiement. Signez un paiement USDC pour l'une des options Base ou Solana renvoyées, resoumettez, et Venice crédite votre solde. |
| **Chaque appel d'inférence** | Le serveur MCP envoie `X-Sign-In-With-X: ` ; Venice débite votre solde prépayé. |
Le top-up minimum est de **5 \$ USD**. Le solde minimum pour appeler l'inférence est de **0,10 \$**. Une fois rechargés, les appels prennent moins de 100 ms car le règlement a lieu hors chaîne sur un compte de crédit rapide.
Les wallets liés à un compte Venice avec du DIEM staké consomment depuis le solde de staking au lieu des crédits USDC, donc aucun top-up n'est nécessaire.
## Auto-hébergement (Streamable HTTP)
Pour les déploiements en équipe ou en workspace, exécutez le serveur MCP via HTTP au lieu de stdio :
```bash theme={"system"}
docker run -p 3333:3333 \
-e VENICE_API_KEY= \
-e VENICE_MCP_AUTH_TOKEN= \
ghcr.io/veniceai/venice-mcp-server:latest
```
Le serveur est désormais disponible à l'adresse `http://localhost:3333/mcp`. Les clients HTTP doivent envoyer `Authorization: Bearer `.
`/mcp` est un endpoint d'exécution d'outils adossé à des identifiants : les appelants peuvent dépenser la clé API Venice configurée ou le solde x402. Lorsque le mode HTTP s'expose au-delà de loopback, le démarrage échoue si `VENICE_MCP_AUTH_TOKEN` n'est pas défini. En production, épinglez explicitement une version du paquet npm plutôt que de vous reposer sur `latest`.
## Ressources
Code source, issues et releases
`@veniceai/mcp-server`
Skills compagnons qui apprennent aux agents à utiliser ces outils
En savoir plus sur le Model Context Protocol