@open-mcp/venice-ai

Installing

First set the environment variables as shell variables:

API_KEY='...'

Then use the OpenMCP config CLI to add the server to your MCP client:

Claude desktop

npx @open-mcp/config add venice-ai \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json \
  --API_KEY=$API_KEY

Cursor

Run this from the root of your project directory or, to add to all cursor projects, run it from your home directory ~.

npx @open-mcp/config add venice-ai \
  .cursor/mcp.json \
  --API_KEY=$API_KEY

Other

npx @open-mcp/config add venice-ai \
  /path/to/client/config.json \
  --API_KEY=$API_KEY

Manually

If you don't want to use the helper above, add the following to your MCP client config manually:

{
  "mcpServers": {
    "venice-ai": {
      "command": "npx",
      "args": ["-y", "@open-mcp/venice-ai"],
      "env": {"API_KEY":"..."}
    }
  }
}

Customizing the base URL

Set the environment variable OPEN_MCP_BASE_URL to override each tool's base URL. This is useful if your OpenAPI spec defines a relative server URL.

Other environment variables

• API_KEY

Inspector

Needs access to port 3000 for running a proxy server, will fail if http://localhost:3000 is already busy.

npx -y @modelcontextprotocol/inspector npx -y @open-mcp/venice-ai

• Open http://localhost:5173
• Transport type: STDIO
• Command: npx
• Arguments: -y @open-mcp/venice-ai
• Click Environment Variables to add
• Click Connect

It should say MCP Server running on stdio in red.

• Click List Tools

Tools

expandSchema

Expand the input schema for a tool before calling the tool

Input schema

• toolName (string)
• jsonPointers (array)

createchatcompletion

Environment variables

• API_KEY

Input schema

• frequency_penalty (number)
• max_completion_tokens (integer)
• max_temp (number)
• max_tokens (integer)
• messages (array)
• min_p (number)
• min_temp (number)
• model (string)
• n (integer)
• presence_penalty (number)
• repetition_penalty (number)
• seed (integer)
• stop (other)
• stop_token_ids (array)
• stream (boolean)
• stream_options (object)
• temperature (number)
• top_k (integer)
• top_p (number)
• user (string)
• venice_parameters (object)
• parallel_tool_calls (boolean)
• response_format (other)
• tool_choice (other)
• tools (array)
• Accept-Encoding (string)

generateimage

Environment variables

• API_KEY

Input schema

• cfg_scale (number)
• embed_exif_metadata (boolean)
• format (string)
• height (integer)
• hide_watermark (boolean)
• inpaint (object)
• lora_strength (integer)
• model (string)
• negative_prompt (string)
• prompt (string)
• return_binary (boolean)
• safe_mode (boolean)
• seed (integer)
• steps (integer)
• style_preset (string)
• width (integer)
• Accept-Encoding (string)

simplegenerateimage

Environment variables

• API_KEY

Input schema

• background (string)
• model (string)
• moderation (string)
• n (integer)
• output_compression (integer)
• output_format (string)
• prompt (string)
• quality (string)
• response_format (string)
• size (string)
• style (string)
• user (string)
• Accept-Encoding (string)

upscaleimage

Environment variables

• API_KEY

Input schema

No input parameters

get_image_styles

Environment variables

• API_KEY

Input schema

No input parameters

listmodels

Environment variables

• API_KEY

Input schema

• type (other)

listmodeltraits

Environment variables

• API_KEY

Input schema

• type (string)

listmodelcompatibilitymapping

Environment variables

• API_KEY

Input schema

• type (string)

getapikeys

Environment variables

• API_KEY

Input schema

No input parameters

deleteapikey

Environment variables

• API_KEY

Input schema

• id (string)

createapikey

Environment variables

• API_KEY

Input schema

• apiKeyType (string)
• consumptionLimit (object)
• description (string)
• expiresAt (other)

getapikeyratelimits

Environment variables

• API_KEY

Input schema

No input parameters

getapikeyratelimitlogs

Environment variables

• API_KEY

Input schema

No input parameters

getapikeygenerateweb3key

Environment variables

No environment variables required

Input schema

No input parameters

postapikeygenerateweb3key

Environment variables

No environment variables required

Input schema

• apiKeyType (string)
• consumptionLimit (object)
• description (string)
• expiresAt (other)
• address (string)
• signature (string)
• token (string)

listcharacters

Environment variables

• API_KEY

Input schema

No input parameters

createspeech

Environment variables

• API_KEY

Input schema

• input (string)
• model (string)
• response_format (string)
• speed (number)
• streaming (boolean)
• voice (string)

getbillingusage

Environment variables

• API_KEY

Input schema

• currency (string)
• endDate (string)
• limit (integer)
• page (integer)
• sortOrder (string)
• startDate (string)
• Accept (string)