> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-responses-api.mintlify.site/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 y embeddings a Claude Desktop, Cursor y 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.

<Card title="GitHub: veniceai/venice-mcp-server" icon="github" href="https://github.com/veniceai/venice-mcp-server">
  Publicado como [`@veniceai/mcp-server`](https://www.npmjs.com/package/@veniceai/mcp-server) en npm. Licencia MIT.
</Card>

<CardGroup cols={3}>
  <Card title="31 herramientas" icon="toolbox">
    Cada modalidad de Venice en un solo bloque de configuración
  </Card>

  <Card title="Cualquier host MCP" icon="plug">
    Claude Desktop, Cursor, ChatGPT, LM Studio, Continue y más
  </Card>

  <Card title="Auth con monedero (opcional)" icon="wallet">
    Usa una API key o paga por llamada con un monedero firmado por SIWE vía x402
  </Card>
</CardGroup>

## Inicio rápido

<Steps>
  <Step title="Obtén una API key de Venice">
    Genera una en [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation). Consulta la [guía de API key](/guides/getting-started/generating-api-key) para instrucciones paso a paso.
  </Step>

  <Step title="Añade Venice a la configuración de tu host MCP">
    Pega esto en el archivo de configuración de tu host MCP:

    ```json theme={null}
    {
      "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) |
  </Step>

  <Step title="Reinicia tu host MCP">
    Tu agente ahora tiene chat, imagen, vídeo, música, TTS, ASR y 25 herramientas más de Venice disponibles.
  </Step>
</Steps>

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

## 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_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](#modo-monedero-x402). |

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={null}
{
  "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.

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

## Self-hosting (HTTP en streaming)

Para despliegues de equipo o workspace, ejecuta el servidor MCP sobre HTTP en lugar de stdio:

```bash theme={null}
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>`.

<Warning>
  `/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`.
</Warning>

## Recursos

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/venice-mcp-server">
    Código fuente, issues y releases
  </Card>

  <Card title="npm" icon="npm" href="https://www.npmjs.com/package/@veniceai/mcp-server">
    `@veniceai/mcp-server`
  </Card>

  <Card title="Venice Skills" icon="book" href="/guides/integrations/venice-skills">
    Skills complementarias que enseñan a los agentes cómo usar estas tools
  </Card>

  <Card title="Spec de MCP" icon="arrow-up-right-from-square" href="https://modelcontextprotocol.io/">
    Aprende más sobre el Model Context Protocol
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.