> ## 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.
# Venice MCP Server
> El servidor MCP oficial de Venice expone 31 herramientas de chat, imagen, vídeo, audio, música y personajes en cualquier host MCP.
El [Venice MCP Server](https://github.com/veniceai/venice-mcp-server) es el servidor oficial de [Model Context Protocol](https://modelcontextprotocol.io/) 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.
Publicado como [`@veniceai/mcp-server`](https://www.npmjs.com/package/@veniceai/mcp-server) en npm. Licencia MIT.
Cada modalidad de Venice en un solo bloque de configuración
Claude Desktop, Cursor, ChatGPT, LM Studio, Continue y más
Usa una API key o paga por llamada con un monedero firmado por SIWE vía x402
## Inicio rápido
Genera una en [venice.ai/settings/api](https://venice.ai/settings/api). Consulta la [guía de API key](/guides/getting-started/generating-api-key) para instrucciones paso a paso.
Pega esto en el archivo de configuración de tu host MCP:
```json theme={"system"}
{
"mcpServers": {
"venice": {
"command": "npx",
"args": ["-y", "@veniceai/mcp-server@0.2.0"],
"env": { "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) |
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](/guides/integrations/x402-venice-api) 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](#x402-wallet-mode). |
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](/guides/integrations/x402-venice-api) 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.
```json theme={"system"}
{
"mcpServers": {
"venice": {
"command": "npx",
"args": ["-y", "@veniceai/mcp-server@0.2.0"],
"env": { "VENICE_SIWX_TOKEN": "" }
}
}
}
```
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: `; 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:
```bash theme={"system"}
docker run -p 3333:3333 \
-e VENICE_API_KEY= \
-e VENICE_MCP_AUTH_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 `.
`/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
Código fuente, issues y releases
`@veniceai/mcp-server`
Skills complementarias que enseñan a los agentes cómo usar estas tools
Aprende más sobre el Model Context Protocol