Serveur Venice MCP

Le serveur officiel Venice Model Context Protocol avec 31 outils Venice pour tout hôte MCP

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

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

2. 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/mcp-server@0.2.0"],
         "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)

3. 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/mcp-server@0.2.0"],
      "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