Skip to main content
Glama
Venice MCP Server

Venice MCP Server

Official
by veniceai

Venice Responses API

venice_responses

Generate text responses from Venice models through an OpenAI-compatible endpoint with text or image input, reasoning controls, web search, and wallet or API-key authentication.

Instructions

Alpha, stateless OpenAI-compatible Responses API for Venice text models. Supports text/image input and reasoning controls, but this MCP tool does not advertise tool calling because the endpoint does not reliably accept those fields. E2EE-capable models are not supported. Uncensored: NSFW prompts allowed where the model permits. Supports x402 wallet auth (no Venice account needed) and API key.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "input": "<input>"
    },
    "name": "venice_responses"
  }
}

Input Schema

NameRequiredDescriptionDefault
inputYesPlain text or an array of text/image message inputs.
modelNo
top_pNo
reasoningNo
temperatureNo
max_output_tokensNo
venice_parametersNoVenice-only options supported by /responses: web search, citations, scraping, system prompt control, characters.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.3.0
    • changedInput schema / properties / input / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "content": {
      -          "type": "string"
      -        },
      -        "role": {
      -          "enum": [
      -            "system",
      -            "user",
      -            "assistant"
      -          ],
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "role",
      -        "content"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "content": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "items": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "text": {
      +                        "type": "string"
      +                      },
      +                      "type": {
      +                        "enum": [
      +                          "input_text",
      +                          "text",
      +                          "output_text"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "text"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "image_url": {
      +                        "anyOf": [
      +                          {
      +                            "minLength": 1,
      +                            "type": "string"
      +                          },
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "detail": {
      +                                "enum": [
      +                                  "auto",
      +                                  "low",
      +                                  "high"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "minLength": 1,
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          }
      +                        ]
      +                      },
      +                      "type": {
      +                        "enum": [
      +                          "input_image",
      +                          "image_url"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "image_url"
      +                    ],
      +                    "type": "object"
      +                  }
      +                ]
      +              },
      +              "minItems": 1,
      +              "type": "array"
      +            }
      +          ]
      +        },
      +        "role": {
      +          "enum": [
      +            "system",
      +            "developer",
      +            "user",
      +            "assistant"
      +          ],
      +          "type": "string"
      +        },
      +        "type": {
      +          "const": "message",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "role",
      +        "content"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  }
      +]
    • changedInput schema / properties / input / description
      Previous value: -"Either a plain string or an array of role+content messages."New value: +"Plain text or an array of text/image message inputs."
    • addedInput schema / properties / reasoning
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "effort": {
      +      "enum": [
      +        "none",
      +        "minimal",
      +        "low",
      +        "medium",
      +        "high",
      +        "xhigh",
      +        "max"
      +      ],
      +      "type": "string"
      +    },
      +    "summary": {
      +      "enum": [
      +        "auto",
      +        "concise",
      +        "detailed"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / top_p
      Added value: +{
      +  "maximum": 1,
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / venice_parameters
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Venice-only options supported by /responses: web search, citations, scraping, system prompt control, characters.",
      +  "properties": {
      +    "character_slug": {
      +      "description": "Public ID of a Venice character to answer in. Discoverable via venice_list_characters.",
      +      "type": "string"
      +    },
      +    "enable_web_citations": {
      +      "description": "Ask the model to cite web sources with ^1^ style superscripts. Only applies when web search ran.",
      +      "type": "boolean"
      +    },
      +    "enable_web_scraping": {
      +      "description": "Scrape URLs found in the latest user message and feed the contents to the model.",
      +      "type": "boolean"
      +    },
      +    "enable_web_search": {
      +      "description": "Web search. \"on\" forces it, \"auto\" leaves it to the model, \"off\" (default) disables it.",
      +      "enum": [
      +        "auto",
      +        "on",
      +        "off"
      +      ],
      +      "type": "string"
      +    },
      +    "include_venice_system_prompt": {
      +      "description": "Keep Venice's default system prompt alongside your own. Defaults to true; set false for full control of behaviour.",
      +      "type": "boolean"
      +    }
      +  },
      +  "type": "object"
      +}
  2. First observedv0.2.0

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only supply the generic safe-mutation profile (readOnlyHint=false, destructiveHint=false, openWorldHint=true), and the description adds substantial context beyond that: alpha stability, statelessness, deliberate omission of tool-calling fields, E2EE model exclusion, content policy, and two auth modes (x402 wallet or API key). It still omits cost/credit implications and whether output streams, which matter for a paid generation call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences with the identity and stateless/alpha qualifier front-loaded, then constraints, then auth. No filler. The only mild weakness is that the auth sentence arrives last and reads as a list rather than routing guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema and a deeply nested input, the description covers environment and constraints well but leaves the agent without any picture of the return value or how generation output/usage is surfaced. For a seven-parameter nested object with 29% schema coverage, some of that gap should have been closed in prose.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 29%, so the description carries a real burden that it largely does not meet. It gestures at 'text/image input and reasoning controls', but model, temperature, top_p, and max_output_tokens are entirely unexplained, and the seven-value reasoning.effort enum is never characterized (e.g., which models honor 'xhigh'/'max').

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific API surface ('OpenAI-compatible Responses API') for a specific resource (Venice text models) and flags it as stateless and alpha. It falls short of full sibling differentiation: nothing explains why an agent would pick this over venice_chat or venice_chat_with_character, both of which are text-generation siblings in the list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Negative guidance is present and useful: no tool calling, no E2EE models, NSFW allowed where the model permits. But there is no positive routing guidance telling the agent when this endpoint is the right choice versus venice_chat, nor any mention of how to pick a model (venice_list_models) before calling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.