> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-ce69695c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Venice MCP Server

> Der offizielle Venice MCP-Server stellt 31 Tools für Chat, Bild, Video, Audio und Embeddings in Claude Desktop, Cursor und jedem MCP-Host bereit.

Der [Venice MCP Server](https://github.com/veniceai/venice-mcp-server) ist der offizielle [Model Context Protocol](https://modelcontextprotocol.io/)-Server für Venice. Er stellt die gesamte Venice-API (Chat, Image, Video, Audio, Music, Embeddings, Web Augment und Characters) als **31 Tools** bereit, die jeder MCP-kompatible Agent aufrufen kann.

<Card title="GitHub: veniceai/venice-mcp-server" icon="github" href="https://github.com/veniceai/venice-mcp-server">
  Veröffentlicht als [`@veniceai/mcp-server`](https://www.npmjs.com/package/@veniceai/mcp-server) auf npm. MIT-Lizenz.
</Card>

<CardGroup cols={3}>
  <Card title="31 Tools" icon="toolbox">
    Jede Venice-Modalität in einem Konfigurationsblock
  </Card>

  <Card title="Beliebiger MCP-Host" icon="plug">
    Claude Desktop, Cursor, ChatGPT, LM Studio, Continue und mehr
  </Card>

  <Card title="Wallet-Auth (optional)" icon="wallet">
    Nutze einen API-Schlüssel oder zahle pro Aufruf mit einer SIWE-signierten Wallet über x402
  </Card>
</CardGroup>

## Schnellstart

<Steps>
  <Step title="Venice API-Schlüssel besorgen">
    Erstelle einen unter [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation). Schritt-für-Schritt-Anleitung im [API-Schlüssel-Guide](/guides/getting-started/generating-api-key).
  </Step>

  <Step title="Venice zur MCP-Host-Konfiguration hinzufügen">
    Füge dies in die Konfigurationsdatei deines MCP-Hosts ein:

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

    Übliche Konfigurationspfade:

    | Host | Pfad |
    | - | - |
    | 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` (aus den MCP-Einstellungen der App) |
  </Step>

  <Step title="MCP-Host neu starten">
    Dein Agent hat jetzt Chat, Image, Video, Music, TTS, ASR und 25 weitere Venice-Tools verfügbar.
  </Step>
</Steps>

<Note>
  Die meisten MCP-Hosts geben nur Umgebungsvariablen weiter, die **explizit** im `env`-Block aufgeführt sind. System-Env-Vars werden nicht geerbt. Wenn du trotz gesetztem API-Schlüssel 402-Fehler erhältst, prüfe, ob `VENICE_API_KEY` innerhalb von `env` in deiner Konfiguration steht.
</Note>

## Was du bekommst

**31 Tools** für jede Venice-Modalität, **3 Ressourcen** (`venice://models`, `venice://styles`, `venice://voices`) und **3 Prompt-Templates**.

### Chat & Embeddings

| Tool | Beschreibung |
| - | - |
| `venice_chat` | OpenAI-kompatible Chat-Completion gegen Venices vollständigen LLM-Katalog. |
| `venice_responses` | OpenAI-kompatible Responses-API mit Single- oder Multi-Turn-Tool-Unterstützung. |
| `venice_embeddings` | Embeddings für Texteingabe berechnen. |
| `venice_chat_with_character` | Chat mit einem Venice-Character per Slug. |

### Image

| Tool | Beschreibung |
| - | - |
| `venice_image_generate` | Bild generieren (Flux 2, Lustify SDXL, Anime/WAI, Qwen Image, GPT Image, Nano Banana Pro und mehr). |
| `venice_image_edit` | Bild mit einem Prompt bearbeiten. |
| `venice_image_multi_edit` | Mehrere Bilder zusammen mit einem Prompt bearbeiten. |
| `venice_image_upscale` | Bild bis zu 4× hochskalieren. |
| `venice_image_remove_bg` | Bildhintergrund entfernen. |
| `venice_image_styles` | Bildstil-Presets auflisten. |

### Video

| Tool | Beschreibung |
| - | - |
| `venice_video_generate` | Video-Generierungsjob in die Queue stellen (Sora 2, Veo 3.1, Kling, Wan, LTX 2, Seedance, Runway Gen-4 und mehr). |
| `venice_video_status` | Status eines Video-Jobs prüfen. |
| `venice_video_complete` | Fertiges Video als heruntergeladen markieren; löscht serverseitige Medien. |
| `venice_video_quote` | Preis-Quote vor dem Queue-Eintrag bekommen. |

### Audio (TTS / ASR)

| Tool | Beschreibung |
| - | - |
| `venice_tts` | Text-to-Speech mit geklonten Stimmen und Emotions-Tags. |
| `venice_asr` | Audio von einer URL transkribieren. |
| `venice_voice_clone` | Integrierte Stimmen auflisten oder eine Stimme aus einem Sample klonen. |
| `venice_audio_quote` | Preis-Quote für Musikgenerierung bekommen. |

### Musik

| Tool | Beschreibung |
| - | - |
| `venice_music_generate` | Musik-Generierungsjob in die Queue stellen (`ace-step-15`, `elevenlabs-music`, `minimax-music-v2/v25/v26`, `stable-audio-25`, `mmaudio-v2`, `elevenlabs-sound-effects-v2`). |
| `venice_music_status` | Status eines Musik-Jobs prüfen. |
| `venice_music_complete` | Fertigen Musik-Job als heruntergeladen markieren. |

### Web Augment, Katalog und Crypto

| Tool | Beschreibung |
| - | - |
| `venice_web_search` | Im Web suchen (Firecrawl-basiert). |
| `venice_web_scrape` | Eine URL in Markdown scrapen. |
| `venice_text_parser` | Text aus PDF/DOCX/EPUB/PPTX/XLSX extrahieren. |
| `venice_list_models` | Aktuellen Modellkatalog mit Preisen auflisten. |
| `venice_list_characters` | Öffentliche Venice-Characters auflisten. |
| `venice_crypto_rpc` | JSON-RPC-Aufrufe an Base, Ethereum, Polygon, Arbitrum oder Optimism proxien. |

### x402 Wallet-Helfer

Nur relevant, wenn du dich per Wallet über [x402](/guides/integrations/x402-venice-api) statt mit einem API-Schlüssel authentifizierst.

| Tool | Beschreibung |
| - | - |
| `venice_x402_balance` | Prepaid-x402-Guthaben für eine EVM- oder Solana-Wallet-Adresse prüfen. |
| `venice_x402_top_up_info` | Top-up-Anforderungen abrufen (Netzwerk, USDC-Token, Empfänger, Mindestbetrag). |
| `venice_x402_transactions` | Letzte x402-Top-ups und Abbuchungen für eine EVM- oder Solana-Wallet-Adresse auflisten. |

## Konfiguration

Der Server wird vollständig über Umgebungsvariablen konfiguriert.

| Env-Var | Default | Hinweise |
| - | - | - |
| `VENICE_API_KEY` | *(keine)* | Dein Venice API-Schlüssel. Das einfachste Setup. |
| `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` | Auf `1` setzen, um NSFW-Capability-Hinweise aus Tool-Beschreibungen zu entfernen. |
| `VENICE_HTTP_TIMEOUT_MS` | `60000` | |
| `VENICE_SIWX_TOKEN` | *(keiner)* | x402-Wallet-Mode-Auth-Token. Siehe [x402 unten](#x402-wallet-modus). |

Wenn sowohl `VENICE_API_KEY` als auch `VENICE_SIWX_TOKEN` gesetzt sind, gewinnt der API-Schlüssel.

## x402 Wallet-Modus

Venice unterstützt – zusätzlich zum normalen API-Key-Flow – die Authentifizierung mit einem [Sign-In-With-X-Wallet-Token](/guides/integrations/x402-venice-api), der durch Prepaid-USDC-Guthaben auf Base oder Solana gedeckt ist. Keine E-Mail, kein Telefon, kein KYC erforderlich: Deine Wallet ist die einzige Identität.

```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>" }
    }
  }
}
```

Der MCP-Server leitet `VENICE_SIWX_TOKEN` bei jedem Venice-API-Aufruf als `X-Sign-In-With-X`-Header weiter. Der Server sieht nie deinen Private Key. Wallet-Signatur und USDC-Top-up-Autorisierungen erfolgen in deiner eigenen Wallet.

| Flow | Was passiert |
| - | - |
| **Einmalige Einrichtung** | Sign-In-With-X-Nachricht in deiner Wallet signieren → erzeugt einen SIWX-Token (base64 JSON). |
| **Top-up** | `POST /api/v1/x402/top-up` liefert 402 + Zahlungsanforderungen. Eine USDC-Zahlung für eine der zurückgegebenen Base- oder Solana-Optionen signieren, erneut senden, und Venice schreibt deinem Guthaben gut. |
| **Jeder Inferenz-Aufruf** | MCP-Server sendet `X-Sign-In-With-X: <SIWX>`; Venice belastet dein Prepaid-Guthaben. |

Der Mindest-Top-up beträgt **5 USD**. Das Mindest-Guthaben zum Inferenz-Aufruf beträgt **\$0,10**. Nach dem Top-up dauern Aufrufe unter 100 ms, weil die Verrechnung off-chain auf einem schnellen Credit-Konto stattfindet.

<Tip>
  Wallets, die mit einem Venice-Konto mit gestaktem DIEM verknüpft sind, verbrauchen aus dem Staking-Guthaben statt aus USDC-Credits — kein Top-up nötig.
</Tip>

## Self-Hosting (Streamable HTTP)

Für Team- oder Workspace-Deployments läuft der MCP-Server über HTTP statt 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
```

Der Server ist nun unter `http://localhost:3333/mcp` erreichbar. HTTP-Clients müssen `Authorization: Bearer <VENICE_MCP_AUTH_TOKEN>` senden.

<Warning>
  `/mcp` ist ein credential-gestützter Tool-Ausführungs-Endpoint: Aufrufer können den konfigurierten Venice API-Schlüssel oder x402-Guthaben verbrauchen. Wenn der HTTP-Modus außerhalb von Loopback bindet, schlägt der Start fehl, sofern `VENICE_MCP_AUTH_TOKEN` nicht gesetzt ist. Im Produktivbetrieb das npm-Paket explizit auf eine Version pinnen, statt auf `latest` zu vertrauen.
</Warning>

## Ressourcen

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/venice-mcp-server">
    Quellcode, Issues und 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">
    Begleitende Skills, die Agenten beibringen, diese Tools zu verwenden
  </Card>

  <Card title="MCP-Spezifikation" icon="arrow-up-right-from-square" href="https://modelcontextprotocol.io/">
    Mehr über das Model Context Protocol erfahren
  </Card>
</CardGroup>


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