> ## 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
> Der offizielle Venice Model Context Protocol-Server stellt 31 Venice-Tools für Chat, Bild, Video, Audio, Musik und Characters in 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.
Veröffentlicht als [`@veniceai/mcp-server`](https://www.npmjs.com/package/@veniceai/mcp-server) auf npm. MIT-Lizenz.
Jede Venice-Modalität in einem Konfigurationsblock
Claude Desktop, Cursor, ChatGPT, LM Studio, Continue und mehr
Nutze einen API-Schlüssel oder zahle pro Aufruf mit einer SIWE-signierten Wallet über x402
## Schnellstart
Erstelle einen unter [venice.ai/settings/api](https://venice.ai/settings/api). Schritt-für-Schritt-Anleitung im [API-Schlüssel-Guide](/guides/getting-started/generating-api-key).
Füge dies in die Konfigurationsdatei deines MCP-Hosts ein:
```json theme={"system"}
{
"mcpServers": {
"venice": {
"command": "npx",
"args": ["-y", "@veniceai/mcp-server@0.2.0"],
"env": { "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) |
Dein Agent hat jetzt Chat, Image, Video, Music, TTS, ASR und 25 weitere Venice-Tools verfügbar.
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.
## 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_transcriptions` | YouTube-Video-URL transkribieren. |
| `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-mode). |
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={"system"}
{
"mcpServers": {
"venice": {
"command": "npx",
"args": ["-y", "@veniceai/mcp-server@0.2.0"],
"env": { "VENICE_SIWX_TOKEN": "" }
}
}
}
```
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: `; 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.
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.
## Self-Hosting (Streamable HTTP)
Für Team- oder Workspace-Deployments läuft der MCP-Server über HTTP statt 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
```
Der Server ist nun unter `http://localhost:3333/mcp` erreichbar. HTTP-Clients müssen `Authorization: Bearer ` senden.
`/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.
## Ressourcen
Quellcode, Issues und Releases
`@veniceai/mcp-server`
Begleitende Skills, die Agenten beibringen, diese Tools zu verwenden
Mehr über das Model Context Protocol erfahren