Venice MCP Server

El servidor oficial Model Context Protocol de Venice expone 31 herramientas de Venice para chat, imagen, vídeo, audio, música y personajes en cualquier host MCP.

El Venice MCP Server es el servidor oficial de Model Context Protocol para Venice. Expone toda la API de Venice (chat, imagen, vídeo, audio, música, embeddings, web augment y characters) como 31 herramientas que cualquier agente compatible con MCP puede invocar.

GitHub: veniceai/venice-mcp-server

Publicado como @veniceai/mcp-server en npm. Licencia MIT.

31 herramientas

Cada modalidad de Venice en un solo bloque de configuración

Cualquier host MCP

Claude Desktop, Cursor, ChatGPT, LM Studio, Continue y más

Auth con monedero (opcional)

Usa una API key o paga por llamada con un monedero firmado por SIWE vía x402

​

Inicio rápido

1. Obtén una API key de Venice

   Genera una en venice.ai/settings/api. Consulta la guía de API key para instrucciones paso a paso.

2. Añade Venice a la configuración de tu host MCP

   Pega esto en el archivo de configuración de tu host MCP:

   {
     "mcpServers": {
       "venice": {
         "command": "npx",
         "args": ["-y", "@veniceai/mcp-server@0.2.0"],
         "env": { "VENICE_API_KEY": "<your-venice-api-key>" }
       }
     }
   }
   

   Rutas de configuración comunes:

   Host	Ruta
   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 (desde los ajustes de MCP de la app)

3. Reinicia tu host MCP

   Tu agente ahora tiene chat, imagen, vídeo, música, TTS, ASR y 25 herramientas más de Venice disponibles.

La mayoría de hosts MCP solo pasan las variables de entorno listadas explícitamente en el bloque env. Las variables de entorno del sistema no se heredan. Si ves errores 402 con una API key configurada, comprueba que VENICE_API_KEY esté dentro de env en tu configuración.

​

Qué obtienes

31 herramientas que cubren cada modalidad de Venice, 3 recursos (venice://models, venice://styles, venice://voices) y 3 plantillas de prompt.

​

Chat y embeddings

Tool	Descripción
venice_chat	Chat completion compatible con OpenAI contra todo el catálogo de LLM de Venice.
venice_responses	API Responses compatible con OpenAI con soporte de herramientas en uno o múltiples turnos.
venice_embeddings	Calcula embeddings para una entrada de texto.
venice_chat_with_character	Chatea con un character de Venice por su slug.

​

Imagen

Tool	Descripción
venice_image_generate	Genera una imagen (Flux 2, Lustify SDXL, Anime/WAI, Qwen Image, GPT Image, Nano Banana Pro y más).
venice_image_edit	Edita una imagen con un prompt.
venice_image_multi_edit	Edita varias imágenes juntas con un solo prompt.
venice_image_upscale	Escala una imagen hasta 4×.
venice_image_remove_bg	Elimina el fondo de una imagen.
venice_image_styles	Lista los presets de estilo de imagen.

​

Vídeo

Tool	Descripción
venice_video_generate	Encola una generación de vídeo (Sora 2, Veo 3.1, Kling, Wan, LTX 2, Seedance, Runway Gen-4 y más).
venice_video_status	Comprueba el estado de un trabajo de vídeo en cola.
venice_video_complete	Marca un vídeo completado como descargado; borra el contenido del servidor.
venice_video_transcriptions	Transcribe la URL de un vídeo de YouTube.
venice_video_quote	Obtén una cotización de precio antes de encolar.

​

Audio (TTS / ASR)

Tool	Descripción
venice_tts	Texto a voz con voces clonadas y etiquetas de emoción.
venice_asr	Transcribe audio desde una URL.
venice_voice_clone	Lista voces integradas o clona una voz a partir de una muestra.
venice_audio_quote	Obtén una cotización de precio para generación de música.

​

Música

Tool	Descripción
venice_music_generate	Encola generación de música (ace-step-15, elevenlabs-music, minimax-music-v2/v25/v26, stable-audio-25, mmaudio-v2, elevenlabs-sound-effects-v2).
venice_music_status	Comprueba el estado de un trabajo de música en cola.
venice_music_complete	Marca un trabajo de música completado como descargado.

​

Web augment, catálogo y cripto

Tool	Descripción
venice_web_search	Busca en la web (respaldado por Firecrawl).
venice_web_scrape	Raspa una URL convirtiéndola en markdown.
venice_text_parser	Extrae texto de PDF/DOCX/EPUB/PPTX/XLSX.
venice_list_models	Lista el catálogo de modelos en vivo con precios.
venice_list_characters	Lista los characters públicos de Venice.
venice_crypto_rpc	Proxy de llamadas JSON-RPC a Base, Ethereum, Polygon, Arbitrum u Optimism.

​

Helpers de monedero x402

Solo relevantes si te autenticas con un monedero mediante x402 en lugar de una API key.

Tool	Descripción
venice_x402_balance	Comprueba el saldo prepago de créditos x402 para una dirección de monedero EVM o Solana.
venice_x402_top_up_info	Obtén los requisitos de recarga (red, token USDC, receptor, importe mínimo).
venice_x402_transactions	Lista transacciones recientes de recarga y débito x402 para una dirección de monedero EVM o Solana.

​

Configuración

El servidor se configura completamente mediante variables de entorno.

Env var	Predeterminado	Notas
VENICE_API_KEY	(ninguno)	Tu API key de Venice. La configuración más 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	Establece en 1 para eliminar notas de capacidad NSFW de las descripciones de las tools.
VENICE_HTTP_TIMEOUT_MS	60000
VENICE_SIWX_TOKEN	(ninguno)	Token de auth en modo monedero x402. Consulta x402 más abajo.

Si están establecidos tanto VENICE_API_KEY como VENICE_SIWX_TOKEN, gana la API key.

​

Modo monedero x402

Venice admite autenticación con un token Sign-In-With-X de monedero respaldado por crédito USDC prepago en Base o Solana, además del flujo normal de API key. No se requiere email, teléfono ni KYC: tu monedero es la única identidad.

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

El servidor MCP reenvía VENICE_SIWX_TOKEN como cabecera X-Sign-In-With-X en cada llamada a la API de Venice. El servidor nunca ve tu clave privada. La firma del monedero y las autorizaciones de recarga USDC ocurren en tu propio monedero.

Flujo	Qué ocurre
Configuración única	Firma un mensaje Sign-In-With-X en tu monedero → produce un token SIWX (JSON en base64).
Recarga	POST /api/v1/x402/top-up devuelve 402 + requisitos de pago. Firma un pago USDC para una de las opciones devueltas de Base o Solana, reenvía y Venice acredita tu saldo.
Cada llamada de inferencia	El servidor MCP envía X-Sign-In-With-X: <SIWX>; Venice debita tu saldo prepago.

La recarga mínima es de $5 USD. El saldo mínimo para llamar a inferencia es de $0.10. Una vez recargado, las llamadas son sub-100 ms porque la liquidación ocurre off-chain en una cuenta de crédito rápida.

Los monederos vinculados a una cuenta de Venice con DIEM en staking consumen del saldo de staking en lugar de los créditos USDC, por lo que no se necesita recarga.

​

Self-hosting (HTTP en streaming)

Para despliegues de equipo o workspace, ejecuta el servidor MCP sobre HTTP en lugar 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

El servidor está ahora disponible en http://localhost:3333/mcp. Los clientes HTTP deben enviar Authorization: Bearer <VENICE_MCP_AUTH_TOKEN>.

/mcp es un endpoint de ejecución de tools respaldado por credenciales: los llamadores pueden gastar la API key de Venice configurada o el saldo x402. Cuando el modo HTTP se vincula fuera de loopback, el arranque falla salvo que VENICE_MCP_AUTH_TOKEN esté establecido. En producción, fija explícitamente la versión del paquete npm en lugar de depender de latest.

​

Recursos

GitHub

Código fuente, issues y releases

npm

@veniceai/mcp-server

Venice Skills

Skills complementarias que enseñan a los agentes cómo usar estas tools

Spec de MCP

Aprende más sobre el Model Context Protocol