Serveur Venice MCP | Documentation de l'API Venice

Le serveur Venice MCP est le serveur officiel Model Context Protocol 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.

GitHub : veniceai/venice-mcp-server

Publié sous le nom @veniceai/mcp-server sur npm. Licence MIT.

31 outils

Toutes les modalités Venice dans un seul bloc de configuration

Tout hôte MCP

Claude Desktop, Cursor, ChatGPT, LM Studio, Continue, et plus encore

Authentification par wallet (facultatif)

Apportez une clé API, ou payez à l’appel avec un wallet signé via SIWE et x402

Démarrage rapide

Obtenez une clé API Venice

Générez-en une depuis venice.ai/settings/api. Consultez le guide des clés API pour des instructions détaillées.

Ajoutez Venice à la configuration de votre hôte MCP

Insérez ceci dans le fichier de configuration de votre hôte MCP :

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_API_KEY": "<your-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)

Redémarrez votre hôte MCP

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 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.

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 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é.

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_SIWX_TOKEN": "<base64 Sign-In-With-X payload>" }
    }
  }
}

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: <SIWX>` ; 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 :

docker run -p 3333:3333 \
  -e VENICE_API_KEY=<your-venice-api-key> \
  -e VENICE_MCP_AUTH_TOKEN=<choose-a-long-random-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 <VENICE_MCP_AUTH_TOKEN>.

/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

GitHub

Code source, issues et releases

npm

@veniceai/mcp-server

Venice Skills

Skills compagnons qui apprennent aux agents à utiliser ces outils

Spécification MCP

En savoir plus sur le Model Context Protocol

GitHub : veniceai/venice-mcp-server

31 outils

Tout hôte MCP

Authentification par wallet (facultatif)

​Démarrage rapide

​Ce que vous obtenez

​Chat et embeddings

​Image

​Vidéo

​Audio (TTS / ASR)

​Musique

​Web augment, catalogue et crypto

​Helpers wallet x402

​Configuration

​Mode wallet x402

​Auto-hébergement (Streamable HTTP)

​Ressources

GitHub

npm

Venice Skills

Spécification MCP

Démarrage rapide

Ce que vous obtenez

Chat et embeddings

Image

Vidéo

Audio (TTS / ASR)

Musique

Web augment, catalogue et crypto

Helpers wallet x402

Configuration

Mode wallet x402

Auto-hébergement (Streamable HTTP)

Ressources