Venice MCP Server

A Model Context Protocol (MCP) server for Venice AI. Gives AI assistants like Claude access to Venice's text generation, image creation, text-to-speech, embeddings, and account management APIs.

What It Does

This MCP server lets Claude (or any MCP-compatible assistant) use Venice AI's features directly:

Chat with Llama, DeepSeek, Qwen, and other open models
Generate images using Stable Diffusion, FLUX, and more
Create speech from text with natural-sounding voices
Generate embeddings for search and RAG applications
Manage API keys and monitor rate limits

Quick Start

1. Get a Venice API Key

2. Install

npm install -g venice-mcp

3. Configure Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "venice-mcp"],
      "env": {
        "VENICE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop. You'll see Venice tools available in the 🔧 menu.

Available Tools

Generation

Tool	Description
`venice_chat`	Chat with Venice AI language models
`venice_generate_image`	Generate images from text descriptions
`venice_upscale_image`	Upscale and enhance images
`venice_text_to_speech`	Convert text to spoken audio
`venice_create_embeddings`	Generate text embeddings

Discovery

Tool	Description
`venice_list_models`	List available models (text, image, code)
`venice_list_characters`	List character personas

Account Management

Requires an admin-level API key:

Tool	Description
`venice_list_api_keys`	List all API keys
`venice_create_api_key`	Create a new API key
`venice_retrieve_api_key`	Get details for a key
`venice_delete_api_key`	Delete an API key
`venice_get_rate_limits`	View rate limits and usage
`venice_get_rate_limit_logs`	View rate limit history

Examples

Ask Claude to generate an image:

"Use Venice to create an image of a sunset over mountains"

Chat with a specific model:

"Ask Venice's DeepSeek model to explain quantum computing"

Check your usage:

"Show my Venice API rate limits"

Supported Models

Language Models: Llama 3.3 70B, DeepSeek R1, Qwen 3, Mistral, and more
Image Models: Stable Diffusion 3.5, FLUX, Fluently XL
Embeddings: BGE-M3 (1024 dimensions)
TTS: Kokoro with multiple voice options

Run venice_list_models to see all currently available models.

Requirements

Node.js 18+
Venice AI API key

Development

Setup

git clone https://github.com/georgeglarson/venice-mcp.git
cd venice-mcp
npm install
npm run build

Testing

npm test              # Run tests
npm run test:watch    # Watch mode
npm run test:coverage # Coverage report

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE

venice-mcp

Quick Install