Venice MCP Server | Venice API Docs

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

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.

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/[email protected]"],
      "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)

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/[email protected]"],
      "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

GitHub: veniceai/venice-mcp-server

31 herramientas

Cualquier host MCP

Auth con monedero (opcional)

​Inicio rápido

​Qué obtienes

​Chat y embeddings

​Imagen

​Vídeo

​Audio (TTS / ASR)

​Música

​Web augment, catálogo y cripto

​Helpers de monedero x402

​Configuración

​Modo monedero x402

​Self-hosting (HTTP en streaming)

​Recursos

GitHub

npm

Venice Skills

Spec de MCP

Inicio rápido

Qué obtienes

Chat y embeddings

Imagen

Vídeo

Audio (TTS / ASR)

Música

Web augment, catálogo y cripto

Helpers de monedero x402

Configuración

Modo monedero x402

Self-hosting (HTTP en streaming)

Recursos