Venice AI
NPM · @VENICEAI/MCP-SERVER
Images, video, music, speech and private chat from Venice AI's models, on one API key.
Available components
Last scanned (17 hours ago)
Scores higher than 49% of npm servers
Category AI and Machine Learning
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security80
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- 40 of 121 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to veniceai/venice-mcp-server). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 10 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability75
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 7350 tokens (~153/item across 48 items; 45 tools + 3 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage87
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 61% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 47 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Checks we ran (15)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 11 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 10 Nov 26 59
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed npm/@veniceai/mcp-server@0.3.2
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | veniceai/venice-mcp-server |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/veniceai/venice-mcp-server/.github/workflows/npm-publish.yml@refs/tags/v0.3.2 |
| Rekor log index | 3793209671 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:9ffb0ec7cc07ca5e930c018755e8dd760c979fe6b1d381a1b1859a0b52f468898898340ae29db551dd02c289bdac9894543a08dde7ea052461f07c18d |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-mrhx-c7xc-m3w5 | CVE-2023-54404 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 121 packages
| Packages resolved | 121 |
|---|---|
| Stale | 40 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
venice_api_key_rate_limit_logs Venice API Key Rate Limit Logs ~55
Get the last 50 exceeded rate-limit events for the account. This read-only endpoint is experimental. ADMIN API key required — inference keys cannot call this endpoint. This endpoint does not accept x402 wallet auth.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_api_key_rate_limits Venice API Key Rate Limits ~46
Get the current key's balances, access status, tier, expiration, and model-specific rate limits. API key required — this endpoint does not accept x402 wallet auth.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_asr Venice ASR (Speech-to-Text) ~421
Transcribe audio. Fetches the URL server-side and forwards as multipart/form-data file upload. Upstream transcription JSON larger than 1 MiB is rejected so word/character timestamps cannot exhaust memory. Timestamp arrays and transcripts longer than 8000 characters are paged in the MCP result: such a transcription returns result_handle alongside the first page, and every later page must be requested with that handle so the clip is transcribed — and charged — exactly once. Handles are held in memory, per MCP session, for 10 minutes and only the 16 most recent survive, after which paging fails and a fresh transcription is needed. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_url | string | – | Audio to transcribe, as an http(s) URL or an inline base64 data URL. Include a concrete media type in data URLs, e.g. audio/mpeg for MP3 or audio/mp4 for M4A. Required unless result_handle is supplie… |
| language | string | – | – |
| model | string | – | – |
| response_format | string | – | – |
| result_handle | string | – | Handle returned by an earlier paged transcription. Pages that retained result without submitting another transcription, so audio_url is ignored when this is set. Expires after 10 minutes or once 16 n… |
| text_offset | integer | – | Start character of the transcript page (8000 characters each). Defaults to 0. Use result_handle with next_text_offset to read past the first page. |
| timestamp_limit | integer | – | Max entries returned per timestamp array. Defaults to 200. Follow next_timestamp_offset; it is null on the last page. |
| timestamp_offset | integer | – | Start index into each timestamp array (word/segment/char). Defaults to 0. Use result_handle to move past the first page. |
| timestamps | boolean | – | Include word and character timestamps in JSON responses. Defaults to false. |
No output schema declared.
No examples provided.
venice_audio_quote Venice Music Cost Quote ~84
Get a price quote for a music generation BEFORE queuing. Useful for budgeting. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| character_count | integer | – | Required for character-based pricing models. |
| duration_seconds | – | – | Optional duration in seconds as a positive integer or numeric string. Model-specific. |
| model | string | yes | Music model id, e.g. "elevenlabs-music". |
No output schema declared.
No examples provided.
venice_billing_balance Venice Billing Balance ~50
Get current USD, DIEM, and bundled-credit availability for the authenticated Venice account. ADMIN API key required — inference keys cannot call this endpoint. This endpoint does not accept x402 wallet auth.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_billing_usage_analytics Venice Billing Usage Analytics ~135
Get beta aggregated usage by date, model, and API key. Data is cached for 10 minutes. Choose either lookback or a complete start/end date range. ADMIN API key required — inference keys cannot call this endpoint. This endpoint does not accept x402 wallet auth.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | – | – | Custom range end in YYYY-MM-DD format. Requires start_date. |
| lookback | string | – | Relative lookback from 1d through 90d. Cannot be combined with start_date/end_date. |
| start_date | string | – | Inclusive custom range start in YYYY-MM-DD format. Requires end_date. |
No output schema declared.
No examples provided.
venice_billing_usage_history Venice Billing Usage History ~270
Walk detailed billing usage in ascending timestamp order using cursor pagination. Supports complete JSON or upstream CSV pages, defaulting to 10 rows. Pages exceeding 64 KiB fail without returning partial rows or a next cursor. On continuation, send cursor without the original filters; CSV nextCursor values already encode format=csv so a cursor-only follow-up stays on text/csv. This uses /billing/usage-history, never deprecated /billing/usage. ADMIN API key required — inference keys cannot call this endpoint. This endpoint does not accept x402 wallet auth.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | – | – |
| cursor | string | – | Opaque nextCursor from the previous page. CSV pages return a csv: prefix so continuation stays on text/csv. Cannot be combined with filters or page_size. |
| end_timestamp | – | – | Exclusive first-page upper bound, ISO 8601 UTC with Z suffix. |
| format | string | – | Defaults to json. Optional on continuation; CSV nextCursor values already stay on CSV. |
| page_size | integer | – | First-page row count. Defaults to 10. Complete pages larger than 64 KiB are rejected; use smaller pages or narrower timestamp filters. |
| start_timestamp | string | – | Inclusive first-page lower bound, ISO 8601 UTC with Z suffix. |
No output schema declared.
No examples provided.
venice_character_reviews Venice Character Reviews ~67
List paginated public reviews for a Venice character. API key required — this endpoint does not accept x402 wallet auth.
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | – | – |
| pageSize | integer | – | – |
| slug | string | yes | Public character slug, e.g. "alan-watts". |
No output schema declared.
No examples provided.
venice_chat Venice Chat (LLM) ~368
Run an OpenAI-compatible chat completion via Venice's text-model catalog. Calls are non-streaming plaintext. Completion text longer than 8000 characters is truncated and the result reports omitted_chars in structured content. Completion id and actual model, when returned upstream, are available in structured content. Responses marked X-Venice-TEE: true also include a JSON text block for venice_tee_signature. enable_e2ee is rejected: this server does not encrypt chat. Uncensored: NSFW prompts allowed where the model permits. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| max_completion_tokens | integer | – | Maximum visible plus reasoning tokens. Preferred over deprecated max_tokens. |
| max_tokens | integer | – | – |
| messages | array | yes | Chat messages. Multimodal image, audio, video, and file blocks belong in user messages. |
| model | string | – | Model id. Defaults to deepseek-v4-flash-0731. |
| parallel_tool_calls | boolean | – | – |
| prompt_cache_key | string | – | – |
| prompt_cache_retention | string | – | – |
| reasoning | object | – | – |
| reasoning_effort | – | – | Takes precedence over reasoning.effort. |
| response_format | – | – | – |
| stop | – | – | – |
| temperature | number | – | – |
| timeout_ms | integer | – | Upstream timeout for this call, covering the full response body. Long generations may need more than the VENICE_HTTP_TIMEOUT_MS default. |
| tool_choice | – | – | – |
| tools | array | – | – |
| top_p | number | – | – |
| venice_parameters | object | – | Venice-only options: web search, citations, system prompt control, reasoning control, and characters. |
| verbosity | string | – | How much text the model returns. |
No output schema declared.
No examples provided.
venice_chat_with_character Venice Character Chat ~142
Chat with a Venice character by slug. Completion id and actual model, when returned upstream, are available in structured content. Responses marked X-Venice-TEE: true also include a JSON text block for venice_tee_signature. Note: the character lookup itself is API-key-only, but the chat completion supports x402 — so x402 users may need to fetch character info via API key first. Uncensored: NSFW prompts allowed where the model permits.
| Name | Type | Req | Description |
|---|---|---|---|
| character_slug | string | yes | – |
| max_tokens | integer | – | – |
| messages | array | yes | – |
| model | string | – | – |
| temperature | number | – | – |
No output schema declared.
No examples provided.
venice_crypto_networks Venice Crypto RPC Networks ~30
List the live, authoritative network slugs accepted by venice_crypto_rpc. No authentication required.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_crypto_rpc Venice Crypto RPC Proxy ~303
Proxy one JSON-RPC request or a batch of up to 100 requests to a supported blockchain network. Use venice_crypto_networks for the live network list. For a simple call, pass rpc_method/rpc_params; for complete request IDs or batches, pass request. Relays (eth_sendRawTransaction, eth_sendUserOperation, Solana sendTransaction, and Starknet writes) must be sent as single requests (not batched) with idempotency_key; reuse the same key when retrying. Results are returned as compact JSON; responses larger than 64 KiB are rejected after Venice has billed them, so keep queries narrow. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Reuse the same key when retrying a request. Required for eth_sendRawTransaction, eth_sendUserOperation, Solana sendTransaction, and Starknet writes so a lost response is not broadcast again. |
| network | string | yes | Network slug returned by venice_crypto_networks, e.g. "ethereum-mainnet". |
| request | – | – | A single JSON-RPC request object (ID optional) or a non-empty batch of at most 100 request objects (ID required per item). |
| rpc_method | string | – | Convenience form for a single request. Do not combine with request. |
| rpc_params | – | – | Parameters for rpc_method, by position (array) or by name (object). |
No output schema declared.
No examples provided.
venice_embeddings Venice Embeddings ~92
Compute embeddings for text input (OpenAI-compatible). Accepts up to 128 texts per call; split larger jobs into separate batches. Oversized batches are rejected before submission. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| encoding_format | string | – | – |
| input | – | yes | Text or array of at most 128 texts. |
| model | string | yes | Embedding model id. |
No output schema declared.
No examples provided.
venice_get_api_key Venice Get API Key Details ~76
Get metadata, usage, balances, and rate-limit details for one API-key ID. The documented response does not reveal the full key secret. ADMIN API key required — inference keys cannot call this endpoint. This endpoint does not accept x402 wallet auth.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | API-key ID, not the key secret. |
No output schema declared.
No examples provided.
venice_get_character Venice Get Character ~50
Get one public Venice character by slug. API key required — this endpoint does not accept x402 wallet auth.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | Public character slug, e.g. "alan-watts". |
No output schema declared.
No examples provided.
venice_image_edit Venice Image Edit ~186
Edit an image with a prompt. Returns base64 PNG. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| aspect_ratio | string | – | Output aspect ratio, e.g. "1:1", "16:9", "9:16", "4:5". Supported values vary by model; the API validates. |
| enhance_prompt | boolean | – | Rewrite the edit prompt with awareness of the input image. May add time and cost. |
| image_url | string | yes | URL of the image to edit (will be passed through to the edit endpoint). |
| model | string | – | Edit model id; defaults to firered-image-edit. |
| output_format | string | – | – |
| prompt | string | yes | – |
| resolution | string | – | Model-specific output resolution tier; the API validates supported values. |
| safe_mode | boolean | – | – |
No output schema declared.
No examples provided.
venice_image_generate Venice Image Generate ~339
Generate an image. Supports Flux 2 Pro/Max, Lustify SDXL, Anime (WAI), Qwen Image, GPT Image, Nano Banana Pro and others. Uncensored: NSFW prompts allowed where the model permits. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| aspect_ratio | string | – | Model-specific aspect ratio such as "1:1" or "16:9"; the API validates supported values. |
| disable_prompt_optimization_thinking | boolean | – | Skip prompt-optimization thinking on supported models. |
| enable_web_search | boolean | – | Allow supported models to use web search; additional credits may apply. |
| enhance_prompt | boolean | – | Rewrite the prompt before generation. Adds up to ~30 seconds and a charge when applied. |
| format | string | – | – |
| height | integer | – | – |
| model | string | – | Defaults to flux-2-pro. |
| negative_prompt | string | – | – |
| prompt | string | yes | – |
| quality | string | – | Model-specific quality tier; may change pricing. |
| resolution | string | – | Model-specific resolution tier such as "1K", "2K", or "4K"; the API validates supported values. |
| safe_mode | boolean | – | – |
| seed | integer | – | – |
| steps | integer | – | – |
| style_preset | string | – | See venice://styles. |
| style_references | array | – | Model-specific style references. Check the model maxStyleReferences capability. |
| variants | integer | – | Number of images. Only supported with non-binary responses. |
| width | integer | – | – |
No output schema declared.
No examples provided.
venice_image_multi_edit Venice Image Multi-Edit ~178
Edit multiple images together with a single prompt (multi-image composition / outpainting). Returns base64 PNG. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| aspect_ratio | string | – | Output aspect ratio, e.g. "1:1", "16:9", "9:16", "4:5". Supported values vary by model; the API validates. |
| enhance_prompt | boolean | – | Rewrite the edit prompt with awareness of the input images. May add time and cost. |
| image_urls | array | yes | – |
| model | string | – | – |
| output_format | string | – | – |
| prompt | string | yes | – |
| quality | string | – | Model-specific quality tier; may change pricing. |
| resolution | string | – | Model-specific output resolution tier; the API validates supported values. |
No output schema declared.
No examples provided.
venice_image_remove_bg Venice Image Background Remove ~46
Remove image background; returns a transparent PNG (base64). Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| image_url | string | yes | – |
No output schema declared.
No examples provided.
venice_image_styles Venice Image Styles ~25
List image style presets available for venice_image_generate. No authentication required.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_image_upscale Venice Image Upscale ~177
Upscale an image (2-4× scale). Endpoint requires base64 image; this tool fetches the URL and uploads it. Returns base64 PNG. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| creativity | number | – | How much detail and texture the upscaler invents, 0 to 0.02. Defaults to 0.01. Higher stays further from the source. |
| image_url | string | yes | Image to upscale: an http(s) URL or an inline base64 data URL. Include a concrete media type in data URLs, e.g. image/jpeg. |
| scale | number | – | Upscale factor, 2 to 4. Defaults to 2. Large inputs are scaled down automatically to stay under the 4096x4096 output cap. |
No output schema declared.
No examples provided.
venice_list_api_keys Venice List API Keys ~51
List active API-key metadata, including only the documented last six characters—not full key secrets. ADMIN API key required — inference keys cannot call this endpoint. This endpoint does not accept x402 wallet auth.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_list_characters Venice List Characters ~133
List public Venice characters. API key required — this endpoint does not accept x402 wallet auth.
| Name | Type | Req | Description |
|---|---|---|---|
| categories | array | – | – |
| isAdult | boolean | – | – |
| isPro | boolean | – | – |
| isWebEnabled | boolean | – | – |
| limit | integer | – | – |
| modelId | array | – | – |
| offset | integer | – | – |
| search | string | – | – |
| sortBy | string | – | – |
| sortOrder | string | – | – |
| tag | string | – | Deprecated: use tags. A single tag, merged into tags. |
| tags | array | – | – |
No output schema declared.
No examples provided.
venice_list_models Venice List Models ~235
List the live model catalog, one page at a time. Omitting type lists every model type (sent upstream as type=all). Each entry is a compact summary (id, type, name, context length, enabled capabilities, traits, privacy, pricing); set verbose=true for the full upstream model objects. Returns total, next_offset, and every matching model id in ids; call again with offset=next_offset until next_offset is null. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max models per page. Defaults to 50. A page may hold fewer when entries are large; follow next_offset. |
| offset | integer | – | Index of the first model to return. Defaults to 0. |
| type | string | – | Catalog type: text, image, inpaint, upscale, video, music, tts, asr, embedding, decision, "code", or "all" (default). Without a type Venice returns only text models, so pass one to find video, image… |
| verbose | boolean | – | Return full upstream model objects instead of compact summaries. Defaults to false. |
No output schema declared.
No examples provided.
venice_model_compatibility_mapping Venice Model Compatibility Mapping ~80
Return the live compatible model-name to Venice model-id mapping for a model type. The API defaults to text when type is omitted. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| type | string | – | Catalog type: text, image, inpaint, upscale, video, music, tts, asr, embedding, decision. Defaults to text upstream. |
No output schema declared.
No examples provided.
venice_model_details Venice Model Details ~110
Get one exact model's full catalog row, including model_spec constraints, capabilities, and pricing when available. Requires a concrete type to keep the upstream catalog response bounded. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| model_id | string | yes | Exact model id, e.g. from venice_list_models({ type: "video" }). |
| type | string | yes | Catalog type the model belongs to: text, image, inpaint, upscale, video, music, tts, asr, embedding, decision. |
No output schema declared.
No examples provided.
venice_model_traits Venice Model Traits ~75
Return the live trait-name to model-id mapping for a model type. The API defaults to text when type is omitted. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| type | string | – | Catalog type: text, image, inpaint, upscale, video, music, tts, asr, embedding, decision. Defaults to text upstream. |
No output schema declared.
No examples provided.
venice_music_complete Venice Music Complete (cleanup) ~61
Mark a completed music job as downloaded and delete server-side media. Reports removal only when Venice confirms success. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | yes | – |
| queue_id | string | yes | – |
No output schema declared.
No examples provided.
venice_music_generate Venice Music Queue ~321
Queue music generation. Available models: ace-step-15, elevenlabs-music, minimax-music-v2/v25/v26, stable-audio-25, mmaudio-v2-text-to-audio, elevenlabs-sound-effects-v2. Uncensored: NSFW prompts allowed where the model permits. Supports x402 wallet auth (no Venice account needed) and API key. Returns { model, queue_id }; poll with venice_music_status.
| Name | Type | Req | Description |
|---|---|---|---|
| duration_seconds | – | – | Optional duration in seconds as a positive integer or numeric string. Model-specific. |
| force_instrumental | boolean | – | Only for models reporting supports_force_instrumental. |
| instrumental | boolean | – | Deprecated: use force_instrumental. Ignored when force_instrumental is set. |
| language_code | string | – | ISO 639-1 language code on supported models. |
| loop | boolean | – | Create a seamless loop on models reporting supports_loop. |
| lyrics | string | – | Deprecated: use lyrics_prompt. Ignored when lyrics_prompt is set. |
| lyrics_optimizer | boolean | – | Auto-generate lyrics. lyrics_prompt must be empty when enabled. |
| lyrics_prompt | string | – | Lyrics/text for lyric-capable models. Length limits come from model metadata. |
| model | string | yes | Required. Music model id, e.g. "elevenlabs-music". |
| prompt | string | yes | – |
| speed | number | – | Model-specific speed multiplier. Check model min_speed/max_speed. |
| voice | string | – | Model-supported voice id/name. |
No output schema declared.
No examples provided.
venice_music_status Venice Music Retrieve / Status ~129
Check status of a queued music job. Returns JSON progress while PROCESSING. Completed jobs are either an embedded base64 audio MCP resource or a download_url resource link. POST endpoint with body {model, queue_id}. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| delete_media_on_completion | boolean | – | Delete server-side media after embedded audio has been buffered, before the tool result returns to the client. Ignored for download_url results: download first, then call venice_music_complete. |
| model | string | yes | – |
| queue_id | string | yes | – |
No output schema declared.
No examples provided.
venice_responses Venice Responses API ~171
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.
| Name | Type | Req | Description |
|---|---|---|---|
| input | – | yes | Plain text or an array of text/image message inputs. |
| max_output_tokens | integer | – | – |
| model | string | – | – |
| reasoning | object | – | – |
| temperature | number | – | – |
| top_p | number | – | – |
| venice_parameters | object | – | Venice-only options supported by /responses: web search, citations, scraping, system prompt control, characters. |
No output schema declared.
No examples provided.
venice_tee_attestation Venice TEE Attestation ~128
Fetch hardware-attestation evidence for a TEE-capable text model. The caller must supply a fresh 32-byte nonce and independently verify the echoed nonce, Intel TDX quote, optional NVIDIA evidence, debug-mode state, and signing-key binding before trusting the key. Fetching this evidence does not itself establish E2EE. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | yes | TEE-capable text model id; check supportsTeeAttestation in venice_list_models. |
| nonce | string | yes | Caller-generated 32-byte freshness challenge encoded as exactly 64 hexadecimal characters. |
No output schema declared.
No examples provided.
venice_tee_signature Venice TEE Response Signature ~106
Fetch the enclave signature for a completed TEE text-model chat request. The caller must cryptographically verify it against the signing identity bound by a separately verified attestation; this tool only returns the provider payload. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | yes | Actual TEE-capable model returned in the chat completion metadata. |
| request_id | string | yes | Completion id returned by venice_chat or venice_chat_with_character, in structured content or the additional metadata text block. |
No output schema declared.
No examples provided.
venice_text_parser Venice Text Parser (PDF/DOCX/EPUB/PPTX/XLSX) ~101
Extract text from a document URL. Fetches the URL server-side and uploads the file as multipart/form-data. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Document to parse: an http(s) URL or an inline base64 data URL. Include a concrete media type in data URLs, e.g. application/pdf or application/vnd.openxmlformats-officedocument.wordprocessingml.docu… |
No output schema declared.
No examples provided.
venice_tts Venice TTS (Speech) ~180
Convert text to speech. Supports cloned voices + emotion tags ([whispers], [sarcastically], etc.). When streaming=true, Venice streams upstream but this MCP tool buffers and returns one complete audio result; it does not emit incremental MCP chunks. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| input | string | yes | Text to convert to speech (max 4096 chars). |
| model | string | – | – |
| response_format | string | – | – |
| speed | number | – | – |
| streaming | boolean | – | Forward Venice's streaming flag. The MCP result is still buffered into one complete audio response, not delivered incrementally. |
| temperature | number | – | Sampling temperature. Only supported by some TTS models; unsupported models ignore it. |
| voice | string | – | Voice id; see venice://voices. |
No output schema declared.
No examples provided.
venice_video_complete Venice Video Complete (cleanup) ~60
Mark a completed video as downloaded and delete server-side media. Reports removal only when Venice confirms success. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | yes | – |
| queue_id | string | yes | – |
No output schema declared.
No examples provided.
venice_video_generate Venice Video Queue ~1,130
Queue a video generation. Supports Veo 3.1, Kling, Wan, Seedance, MiniMax, PixVerse, Runway, LTX, Grok Imagine, and others. Pick a specific id like "veo3.1-fast-text-to-video", "veo3.1-fast-image-to-video", "kling-2.6-pro-text-to-video", "wan-2.6-text-to-video", "seedance-2-5-reference-to-video-basic" etc. Uncensored: NSFW prompts allowed where the model permits. Supports x402 wallet auth (no Venice account needed) and API key. Returns { model, queue_id }; poll with venice_video_status. NOTE: 'duration' is a model-specific string enum like '4s' / '6s' / '8s'; inspect it with venice_model_details. Current public Seedance models may reject detectable persons outright. Consent flags are defensive compatibility support, not a policy bypass; set them only after showing a returned policy to the user and receiving explicit confirmation.
| Name | Type | Req | Description |
|---|---|---|---|
| aspect_ratio | string | – | Output aspect ratio, e.g. "16:9", "9:16", "1:1", "4:5", "9:21". Model-specific; see venice_model_details. |
| audio | boolean | – | Enable or disable audio generation for models that support it. Defaults to true. |
| audio_url | string | – | For models that support audio input: background music. URL or data URL. Supported: WAV, MP3. Max 30s, 15MB. |
| camera_trajectory | array | – | For minimax-h3-max-multi-angle only: 2–12 camera keyframes with strictly increasing time from 0 to 1, azimuth in degrees (signed, at most 32 full turns of travel in total), elevation from -90 to 90 d… |
| consents | object | – | Defensive compatibility support for a returned Seedance needs_consent flow. Current public models may reject detectable persons outright. All three flags must be true after explicit user confirmation… |
| duration | string | yes | Duration as model-specific string enum, e.g. "4s", "6s", "8s". See venice_model_details. |
| elements | array | – | For Kling O3 R2V and similar: up to 4 character/object elements. Reference in prompt as @Element1, @Element2, etc. |
| end_image_url | string | – | For models that support end frames or transitions. URL or data URL. |
| image_url | string | – | For image-to-video models: starting frame. URL or data URL. |
| model | string | yes | Required. Full model id, e.g. "veo3.1-fast-text-to-video". |
| negative_prompt | string | – | Negative prompt (what to avoid). Supported by Seedance and other models. |
| omni_reference_task_type | string | – | For seedance-2-5-reference-to-video-basic only: what to do with reference_video_urls. "edit" changes the referenced clip and "extend" continues it; both need reference_video_urls and a prompt that as… |
| prompt | string | yes | – |
| reference_audio_urls | array | – | For Seedance 2.0 R2V and similar: up to 3 reference audio clips for vocal timbre, narration, or sound effects. Per-clip 2–15s, WAV/MP3; aggregate ≤15s. Must be paired with at least one reference imag… |
| reference_image_urls | array | – | For models with reference image support: up to 9 images for character/style consistency. Each a URL or data URL. |
| reference_video_urls | array | – | For Seedance 2.0 R2V and similar: up to 3 reference video clips to inherit subject motion, camera movement, and style. Per-clip 2–15s, MP4/MOV, ≤50MB; aggregate ≤15s. Each a URL or data URL. |
| resolution | string | – | Output resolution, e.g. "720p", "1080p", "4k". Model-specific; see venice_model_details. |
| scene_image_urls | array | – | For models with advanced element support: up to 4 scene reference images. Reference in prompt as @Image1, @Image2, etc. |
| seed | integer | – | – |
| upscale_factor | integer | – | For upscale models only: 1 = quality enhance, 2 = double resolution, 4 = quadruple. |
| video_references | array | – | For models with per_reference_audio, e.g. wan-2-7-reference-to-video: reference clips, up to the model's reference-video limit. Each has an optional ref_name to cite in the prompt and an optional aud… |
| video_url | string | – | For video-to-video and upscale models (e.g. wan-2-7-video-to-video, topaz-video-upscale): input video. URL or data URL. Supported: MP4, MOV, WebM. |
No output schema declared.
No examples provided.
venice_video_quote Venice Video Cost Quote ~78
Get a price quote for a video generation BEFORE queuing. No authentication required.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | string | yes | Duration as model-specific string enum, e.g. "4s", "6s", "8s". |
| model | string | yes | Video model id, e.g. "veo3.1-fast-text-to-video". |
No output schema declared.
No examples provided.
venice_video_status Venice Video Retrieve / Status ~239
Check status of a queued video job. Returns JSON progress while PROCESSING. Completed jobs are either an embedded base64 video/mp4 MCP resource or a download_url resource link. For VPS / Grok Imagine Private models, retrieve returns COMPLETED JSON without a URL: this process reuses the queue-time download_url when venice_video_generate ran here, or accepts a Venice-host download_url argument. POST endpoint with body {model, queue_id}. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| delete_media_on_completion | boolean | – | Delete server-side media after an embedded MP4 has been buffered, before the tool result returns to the client. Ignored for download_url results: download first, then call venice_video_complete. |
| download_url | string | – | Queue-time download_url from venice_video_generate. Must be an https Venice host. Needed for VPS / Grok Imagine Private only when this process did not queue the job (retrieve returns COMPLETED withou… |
| model | string | yes | Same model id used to queue. |
| queue_id | string | yes | Returned by venice_video_generate. |
No output schema declared.
No examples provided.
venice_voice_clone Venice Voice Clone / List ~249
Discover or clone TTS voices. Action 'list' reads live per-model voice metadata from auth-free GET /v1/models?type=tts. Action 'create' requires sample_url, then uploads the sample to POST /v1/audio/voices for the chosen cloning model. Cloned voices come back as a `vv_<id>` handle; pass it as venice_tts voice together with the same model. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | list = fetch live TTS model voice metadata; create requires sample_url |
| model | string | – | TTS model the cloned voice is paired with (action=create). Defaults to tts-chatterbox-hd. |
| sample_url | string | – | Required for action=create. Audio sample as an http(s) URL or an inline base64 data URL; tts-chatterbox-hd accepts MP3/WAV/FLAC/M4A, tts-minimax-speech-02-hd MP3/WAV only. Include a concrete media ty… |
No output schema declared.
No examples provided.
venice_web_scrape Venice Web Scrape ~48
Scrape one URL into markdown text. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | – |
| url | string | yes | – |
No output schema declared.
No examples provided.
venice_web_search Venice Web Search ~116
Search the web with Brave Search (default, Zero Data Retention), Google Search (proxied and anonymized by Venice), or Exa (Zero Data Retention). Returns structured results with titles, URLs, snippets, and dates. Supports x402 wallet auth (no Venice account needed) and API key.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| query | string | yes | – |
| search_provider | string | – | brave (default) and exa use Zero Data Retention; google is proxied/anonymized by Venice. |
No output schema declared.
No examples provided.
venice_x402_balance Venice x402 Wallet Balance ~79
Check the prepaid x402 credit balance for an EVM or Solana wallet address. SIWX-ONLY: this endpoint rejects API key auth and requires SIGN-IN-WITH-X (forwarded from VENICE_SIWX_TOKEN). The wallet in the path must match the SIWX-authenticated wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| wallet_address | string | yes | – |
No output schema declared.
No examples provided.
venice_x402_top_up_info Venice x402 Top-up Requirements ~89
Fetch the x402 top-up payment requirements: the accepted USDC payment options (currently Base and Solana), each with network, asset, receiver wallet (payTo), minimum amount in base units, and settlement timeout. Sends an empty POST with no payment header, so nothing is charged. Signing and PAYMENT-SIGNATURE submission happen OUTSIDE this MCP server. No authentication required.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
venice_x402_transactions Venice x402 Transaction History ~81
List recent x402 top-up + debit transactions for an EVM or Solana wallet. SIWX-ONLY: rejects API key, requires SIGN-IN-WITH-X (VENICE_SIWX_TOKEN). The wallet in the path must match the SIWX-authenticated wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| wallet_address | string | yes | – |
No output schema declared.
No examples provided.
How do I install the Venice AI MCP server?
Venice AI runs locally as an npm package, launched with npx -y @veniceai/mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @veniceai/mcp-server
claude mcp add veniceai-venice-mcp-server -- npx -y @veniceai/mcp-server
What is the Venice AI MCP server?
Venice AI is an MCP server listed in the public MCP registry as io.github.veniceai/venice-mcp-server. Images, video, music, speech and private chat from Venice AI's models, on one API key. This page covers its npm package (@veniceai/mcp-server).
Is the Venice AI MCP server safe to use?
Venice AI scores 74 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 21 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Venice AI MCP server expose?
Venice AI exposes 45 tools: venice_chat, venice_responses, venice_embeddings, venice_image_generate, venice_image_edit, and 40 more. Their descriptions and schemas cost roughly 7,190 tokens of context every time the server is loaded.
Is the Venice AI MCP server still maintained?
Venice AI is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Venice AI MCP server under?
Venice AI declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the Venice AI MCP server?
VerifyMCP ran 15 checks on Venice AI, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Venice AI: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.