TokenLab MCP Server
NPM · @TOKENLABAI/MCP-SERVER · SCANNED SEP 20
TokenLab MCP server: 31 default and 80 full-profile tools for models, media, tasks, and files.
Available components
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 Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 95 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 hedging8563/tokenlab-mcp-server). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability72
- 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 6753 tokens (~198/item across 34 items; 31 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 Management93
- Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage89
- 97% of tools have a non-trivial description (not blank, and not just the tool's name).Partial
- 75% 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 33 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
How do I install the TokenLab MCP Server server?
TokenLab MCP Server runs locally as an npm package, launched with npx -y @tokenlabai/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 · @tokenlabai/mcp-server
claude mcp add hedging8563-tokenlab -- npx -y @tokenlabai/mcp-server
{
"mcpServers": {
"hedging8563-tokenlab": {
"command": "npx",
"args": [
"-y",
"@tokenlabai/mcp-server"
]
}
}
} {
"servers": {
"hedging8563-tokenlab": {
"command": "npx",
"args": [
"-y",
"@tokenlabai/mcp-server"
]
}
}
} codex mcp add hedging8563-tokenlab -- npx -y @tokenlabai/mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"hedging8563-tokenlab": {
"type": "local",
"command": [
"npx",
"-y",
"@tokenlabai/mcp-server"
],
"enabled": true
}
}
} openclaw mcp add hedging8563-tokenlab --command npx --arg -y --arg @tokenlabai/mcp-server
mcp_servers:
hedging8563-tokenlab:
command: "npx"
args: ["-y", "@tokenlabai/mcp-server"] {
"McpServers": {
"hedging8563-tokenlab": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@tokenlabai/mcp-server"
]
}
}
} assistant mcp add hedging8563-tokenlab -t stdio -c npx -a -y @tokenlabai/mcp-server
{
"mcpServers": {
"hedging8563-tokenlab": {
"command": "npx",
"args": [
"-y",
"@tokenlabai/mcp-server"
]
}
}
} 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.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −3
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Malware scan: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- Tool coverage: 97 → unverified ▼ functional
- Stability: pass → 0.80 functional
- Package version: 0.6.17 → 0.6.20 functional
- Package version: 0.6.17 → 0.6.19 functional
- 15 Sept 26 0
- Stability: 0.97 → pass security
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 −3
- Stability: pass → 0.80 functional
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 20 Sept 2026 · Analysed npm/@tokenlabai/mcp-server@0.6.20
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 | hedging8563/tokenlab-mcp-server |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/hedging8563/tokenlab-mcp-server/.github/workflows/publish-npm.yml@refs/heads/main |
| Rekor log index | 2866993646 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:a14040a3c247b8913b4d46e0bd9dac93cb6608d07ff54d8c96564d820ad7cb545577942c8c62367f870e5fde44a97c04f734545b4130042a48ca617ef |
Background: How many MCP packages publish verified provenance →
Dependencies 95 packages
| Packages resolved | 95 |
|---|---|
| Stale | 31 |
| 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 →
cancel_task Cancel async task ~114
Cancel async task Cancels a queued asynchronous task when cancellation is supported for the selected task. Cancellation currently supports queued Seedance video tasks (`seedance-1.5-pro`, `seedance-2.0`, and `seedance-2.0-fast`) while they are still waiting to run. Tasks that are already processing, completed, failed, expired, or unsupported are not cancelled.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The async task ID returned by `id` / `task_id`, or embedded in `poll_url` |
No output schema declared.
No examples provided.
compare_models Compare TokenLab Models ~36
Compare public TokenLab model details and pricing for several model IDs.
| Name | Type | Req | Description |
|---|---|---|---|
| include_raw | boolean | – | – |
| models | array | yes | – |
No output schema declared.
No examples provided.
create_3d_model Create 3D model generation task ~166
Create 3D model generation task Creates a 3D model generation task using Tripo3D. Returns a task ID for polling.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| format | string | – | – |
| image | string | – | Base64 image for image-to-3D |
| image_url | string | – | – |
| model | string | – | – |
| prompt | string | yes | 3D model description |
| quality | string | – | – |
| seed | integer | – | Seed for deterministic-compatible providers. |
| style | string | – | Style hint for compatible 3D model families. |
| user | string | – | End-user identifier. |
No output schema declared.
No examples provided.
create_anthropic_message Create message (Anthropic-compatible) ~264
Create message (Anthropic-compatible) Creates a model response using Anthropic's native request format. Supports Claude models with vision and streaming. **Authentication:** Use `x-api-key` header or `Authorization: Bearer` header.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| max_tokens | integer | yes | Maximum number of tokens to generate |
| messages | array | yes | Messages in the conversation |
| metadata | object | – | Request metadata echoed into downstream logs or traces when supported. |
| model | string | yes | Model to use (e.g., claude-sonnet-4-6) |
| service_tier | string | – | Service tier hint for compatible providers. |
| stop_sequences | array | – | – |
| stream_options | object | – | Streaming options such as usage chunk inclusion. |
| system | string | – | System prompt |
| temperature | number | – | – |
| thinking | object | – | Thinking configuration for compatible Anthropic-style models. |
| tool_choice | – | – | Tool choice policy or explicit tool selection. |
| tools | array | – | Tool definitions available to the model. |
| top_k | integer | – | – |
| top_p | number | – | – |
No output schema declared.
No examples provided.
create_chat_completion Create chat completion ~548
Create an OpenAI-compatible chat completion. For inline image_url data URLs, declare the byte-accurate image MIME type. The MCP boundary corrects recognized PNG, JPEG, WebP, and GIF payloads declared as application/octet-stream and rejects unrecognized generic binary image payloads before sending a billable request.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| audio | object | – | Audio output configuration when requesting audio modality. |
| frequency_penalty | number | – | Frequency penalty (-2 to 2) |
| function_call | – | – | Deprecated function-call selection retained by the official Chat Completions contract. |
| functions | array | – | Deprecated function definitions retained by the official Chat Completions contract. |
| logit_bias | object | – | Per-token logit bias map. |
| logprobs | boolean | – | Whether to return log probabilities for output tokens. |
| max_completion_tokens | integer | – | Maximum completion tokens for newer reasoning-enabled model families |
| max_tokens | integer | – | Maximum number of tokens to generate |
| messages | array | yes | A list of messages comprising the conversation |
| modalities | array | – | Requested output modalities such as text or audio. |
| model | string | yes | ID of the model to use (e.g., gpt-5.4, claude-sonnet-4-6) |
| n | integer | – | Number of completions to generate |
| parallel_tool_calls | boolean | – | Whether the model may issue parallel tool calls. |
| prediction | object | – | Prediction hints for providers that support draft or speculative decoding. |
| presence_penalty | number | – | Presence penalty (-2 to 2) |
| reasoning_effort | string | – | Reasoning effort hint for compatible model families. |
| response_format | object | – | Response format specification |
| seed | integer | – | Seed for deterministic generation |
| service_tier | string|null | – | Service tier hint for compatible providers. |
| stop | – | – | Stop sequences |
| stream_options | object | – | Streaming options such as usage chunk inclusion. |
| temperature | number | – | Sampling temperature (0-2) |
| tool_choice | – | – | Controls which function is called |
| tools | array | – | List of tools the model may call |
| top_logprobs | integer | – | Number of most likely tokens to return at each position when logprobs is enabled. |
| top_p | number | – | Nucleus sampling probability |
| translation_options | object | – | Language settings for models that translate audio or video through Chat Completions. |
| user | string | – | End-user identifier for abuse detection |
No output schema declared.
No examples provided.
create_embedding Create embeddings ~110
Create embeddings Creates an embedding vector representing the input text.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| dimensions | integer | – | Output vector dimensions |
| encoding_format | string | – | Output format |
| input | – | yes | Input text(s) or token array(s) to embed. |
| model | string | yes | ID of the model to use |
| user | string | – | End-user identifier |
No output schema declared.
No examples provided.
create_gemini_content Generate content (Gemini-compatible) ~327
Generate content (Gemini-compatible) Generates content using the native Gemini GenerateContent shape. This route is exposed only when the model details advertise Gemini requests and a same-protocol route is currently available. ProtoJSON lowerCamelCase and original proto snake_case field names are preserved. Unknown fields are forwarded best-effort and support is determined by the selected provider. **Authentication:** Use `?key=` query parameter, `x-goog-api-key` header, or `Authorization: Bearer` header.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| cachedContent | string | – | Gemini cached content resource name for compatible models. |
| cached_content | string | – | Original proto field-name spelling of cachedContent. |
| contents | array | yes | Conversation contents |
| generationConfig | object | – | – |
| generation_config | object | – | Original proto field-name spelling of generationConfig. |
| model | string | yes | Model name (e.g., gemini-2.5-pro) |
| safetySettings | array | – | – |
| safety_settings | array | – | Original proto field-name spelling of safetySettings. |
| systemInstruction | object | – | – |
| system_instruction | object | – | Original proto field-name spelling of systemInstruction. |
| toolConfig | object | – | Gemini tool configuration such as functionCallingConfig. |
| tool_config | object | – | Original proto field-name spelling of toolConfig. |
| tools | array | – | Gemini tools. Tool types and combinations are interpreted by the selected service. |
No output schema declared.
No examples provided.
create_image Create image ~503
Create image Creates an image given a prompt.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| aspect_ratio | string | – | Aspect-ratio selector for compatible image model families. |
| async | boolean | – | Return a task before the final image is ready when the selected model supports public async executi… |
| background | string | – | Background handling for compatible image flows. For gpt-image-2 generation and edits, accepted valu… |
| compression | integer | – | Alias for output_compression when supported by the selected model |
| expand_prompt | boolean | – | Ask compatible models to expand or enhance the prompt. |
| image_url | string | – | Single reference image URL for compatible image-to-image models. |
| image_urls | array | – | Reference image URLs for compatible image-to-image models. |
| mask_url | string | – | Optional mask URL for compatible image operations. |
| model | string | yes | Model to use. Send this explicitly; query GET /v1/models?recommended_for=image for current recommen… |
| moderation | string | – | Moderation strictness for compatible image models such as gpt-image-2 |
| n | integer | – | Number of images to generate |
| negative_prompt | string | – | Content to avoid for compatible image models. |
| operation | string | – | Public image operation family. Reference-image models use image-to-image with image_url, image_urls… |
| output_compression | integer | – | Output compression level from 0 to 100 for compressed formats |
| output_format | string | – | Output image format for compatible image models such as gpt-image-2 |
| prompt | string | yes | Image description |
| quality | string | – | Image quality. Defaults and accepted values are model-specific. For gpt-image-2, omit this field or… |
| reference_image_urls | array | – | Alias used by compatible reference-image model families. |
| resolution | string | – | Resolution selector for compatible image model families. |
| response_format | string | – | Response format |
| seed | integer | – | Seed for deterministic-compatible image models. |
| size | string | – | Image size. Defaults are model-specific. For gpt-image-2, omit this field or use auto for automatic… |
| style | string | – | Optional model-specific style selector. Only send when the selected model documents support for thi… |
| user | string | – | End-user identifier |
No output schema declared.
No examples provided.
create_image_file Create image ~269
Create image Creates an image given a prompt.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| aspect_ratio | string | – | – |
| async | boolean | – | – |
| background | string | – | – |
| compression | integer | – | – |
| expand_prompt | boolean | – | – |
| image | string | – | Local reference image upload for compatible image-to-image models. Pass local file path. |
| image_urls | string | – | Comma-separated reference image URLs. |
| mask_url | string | – | – |
| model | string | yes | Model to use. Send this explicitly. |
| moderation | string | – | – |
| n | integer | – | – |
| negative_prompt | string | – | – |
| operation | string | – | – |
| output_compression | integer | – | – |
| output_format | string | – | – |
| prompt | string | yes | Image description |
| quality | string | – | – |
| reference_image_urls | string | – | Comma-separated reference image URLs for compatible model families. |
| resolution | string | – | – |
| response_format | string | – | – |
| seed | integer | – | – |
| size | string | – | – |
| style | string | – | – |
| user | string | – | – |
No output schema declared.
No examples provided.
create_multimodal_embedding Create multimodal embeddings ~105
Create multimodal embeddings Creates embeddings for multimodal input items. Text input is generally available; image input may require feature enablement.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| dimensions | integer | – | Optional embedding dimensionality when supported by the selected model |
| input | – | yes | – |
| model | string | yes | Model to use for multimodal embeddings |
No output schema declared.
No examples provided.
create_music Create music generation task ~273
Create music generation task Creates a music generation task using Suno. Returns a task ID for polling.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| action | string | – | – |
| audio_operation | string | – | Uploaded-audio mode. upload-extend requires continue_at; add-instrumental requires audio_url, title… |
| audio_url | string | – | Publicly reachable reference or uploaded audio URL. Defaults to upload-cover when audio_operation i… |
| continue_at | number | – | Timestamp in seconds for continuation flows. Required when audio_operation is upload-extend. |
| continue_clip_id | string | – | Clip ID to continue when extending an existing generation. |
| make_instrumental | boolean | – | Generate instrumental output without vocals. |
| model | string | – | – |
| mv | string | – | Official Suno model version. Required when creating music (action omitted or MUSIC); omit for lyric… |
| negative_tags | string | – | Styles to avoid. Required when audio_operation is add-instrumental. |
| prompt | string | – | Music description. Required for music, lyrics, upload-cover, and upload-extend requests; omit for a… |
| tags | string | – | – |
| title | string | – | – |
No output schema declared.
No examples provided.
create_response Create response (OpenAI Responses API) ~371
Create response (OpenAI Responses API) Creates a response using the native OpenAI Responses API shape. The model details must advertise the Responses request format and a same-protocol route must be currently available; model names and providers do not imply availability. Unknown request fields are forwarded on a best-effort basis and remain subject to the selected provider's support.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| background | boolean | – | Whether to run the response asynchronously. |
| include | array | – | Additional response sections to include when supported. |
| input | – | – | Input content as a string or structured item array. |
| instructions | string | – | System instructions |
| max_output_tokens | integer | – | Maximum output tokens |
| metadata | object | – | Request metadata. |
| model | string | yes | Model to use |
| parallel_tool_calls | boolean | – | Whether the model may issue parallel tool calls. |
| previous_response_id | string | – | ID of a previous response to continue. |
| prompt | object | – | Reference to a reusable prompt template and variables. |
| reasoning | object | – | Reasoning configuration. |
| service_tier | string|null | – | Service tier hint for compatible providers. |
| store | boolean | – | Whether the response is stored for later retrieval. |
| stream_options | object | – | Responses streaming options. |
| temperature | number | – | – |
| text | object | – | Text formatting options. |
| tool_choice | – | – | Tool choice policy or explicit tool selection. |
| tools | array | – | Tools available to the model. Tool types and combinations are validated by the selected service. |
| top_p | number | – | Nucleus sampling probability. |
| truncation | string | – | Truncation strategy for long conversations. |
No output schema declared.
No examples provided.
create_speech Create speech ~294
Create speech Generates audio from the input text (Text-to-Speech).
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| input | string | yes | Text to synthesize. |
| instructions | string | – | Optional style or delivery instructions for OpenAI-compatible TTS models that support them. |
| language_code | string | – | Optional language code for Gemini, xAI, and compatible TTS routes. |
| model | string | – | TTS model. Query GET /v1/models?recommended_for=tts for the current shortlist. |
| prompt | string | – | Optional speaking style prompt for Gemini TTS models. |
| response_format | string | – | Audio format. Common values include mp3, opus, aac, flac, wav, and pcm. Supported values vary by mo… |
| speed | number | – | Speech speed for model families that support it. |
| stream_format | string | – | TokenLab delivery format. stream_format=sse is not supported for tts-1 or tts-1-hd. |
| temperature | number | – | Sampling temperature for Gemini-compatible TTS routes. |
| voice | – | – | Voice selector for OpenAI-compatible, Gemini, xAI, and MiniMax-compatible routes. Some MiniMax rout… |
| voice_id | string | – | Provider-native voice selector for MiniMax-compatible speech models. |
No output schema declared.
No examples provided.
create_video Create video generation task ~1,253
Create video generation task Creates an asynchronous video generation task. The response returns a canonical task ID and usually a preferred `poll_url`; clients should poll `poll_url` first, or use `/v1/tasks/{id}` as the fixed status endpoint.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| aspect_ratio | string | – | Canonical video aspect ratio. Seedance defaults to adaptive when omitted. The ratio alias is accept… |
| audio_url | string | – | Publicly reachable audio URL for model-specific audio-conditioned video flows. |
| audio_urls | array | – | Compatibility array for audio-conditioned flows when multiple audio references are supported by the… |
| camera_fixed | boolean | – | Optional fixed-camera selector for compatible video models. Seedance 2.0 and Seedance 2.5 do not su… |
| cfg_scale | number | – | Prompt adherence strength (0-20) for models that expose CFG-style control. |
| draft | boolean | – | Seedance 1.5 Pro draft workflow flag. Only supported by draft-capable Seedance routes; draft=true c… |
| draft_task_id | string | – | Seedance 1.5 Pro draft promotion task ID. Provide this instead of draft=true to create the final vi… |
| duration | integer | – | Video duration in seconds. Seedance models also accept -1 to let the model choose within its suppor… |
| effect_type | string | – | Model-specific effect selector for specialized editing flows. |
| end_image | string | – | Last frame image input for start-end-to-video flows. Seedance accepts a public image reference or a… |
| execution_expires_after | integer | – | Optional execution expiry window in seconds for compatible video models. Seedance defaults to 17280… |
| extend_at | integer | – | Model-specific extension start offset used by some video-extension flows. |
| extend_times | string | – | Model-specific extension multiplier or repeat count used by some video-extension flows. |
| fps | integer | – | Frames per second |
| frames | integer | – | Optional frame count for compatible video models. Seedance 1.5 Pro, Seedance 2.0, and Seedance 2.5 … |
| generate_audio | boolean | – | Compatibility alias for output_audio. If more than one audio toggle is provided, all values must ma… |
| image | string | – | Inline image as a data URL (for example, data:image/png;base64,...). Prefer image_url for broader p… |
| image_url | string | – | Publicly reachable image URL for image-to-video generation, or asset://asset-YYYYMMDDHHMMSS-xxxxx f… |
| image_urls | array | – | Image URL array for compatible image-conditioned video flows. Seedance 2.5 accepts up to 30 aggrega… |
| kling_elements | array | – | Kling 3.0 element references for kling-3.0-video image-conditioned requests. Define 1-3 elements an… |
| material_asset_id | string | – | TokenLab Seedance material asset ID returned by /v1/videos/assets, by automatic image preparation, … |
| material_asset_ids | array | – | TokenLab Seedance material asset IDs returned by /v1/videos/assets or by automatic image preparatio… |
| model | string | – | Model to use (e.g., veo3.1, kling-v1) |
| motion_strength | number | – | Motion intensity (0-1) for models that expose it. |
| negative_prompt | string | – | What to avoid in the video |
| operation | string | – | Requested video operation. If omitted, TokenLab infers the operation from the provided inputs. Expl… |
| outputAudio | boolean | – | Compatibility alias for output_audio. If both are provided, they must match. |
| output_audio | boolean | – | Canonical model-dependent audio output toggle. Veo 3 and Seedance requests default to true when omi… |
| output_format | string | – | Video container format for compatible models. Seedance 2.5 supports mp4 and mov; omit this field fo… |
| priority | integer | – | Optional task priority for compatible video models. Do not combine priority with service_tier=flex. |
| prompt | string | – | Video description |
| ratio | string | – | Compatibility alias for aspect_ratio. If both ratio and aspect_ratio are provided, they must match. |
| reference_image_type | string | – | Optional reference image role for models that distinguish between asset and style references. The c… |
| reference_images | array | – | Canonical public reference-image field for reference-to-video conditioning. Seedance 2.5 accepts up… |
| resolution | string | – | Video resolution. Seedance defaults to 720p when omitted; available values are model-dependent. |
| return_last_frame | boolean | – | Return the last generated frame when the selected model supports it. Seedance defaults to false whe… |
| safety_identifier | string | – | Optional safety/user trace identifier for compatible video models. If omitted for Seedance, TokenLa… |
| seconds | integer | – | Alias of duration used by compatible request shapes. Seedance models also accept -1 to let the mode… |
| seed | integer | – | Seed for reproducibility on compatible models. Compatible Seedance models use -1 for a random seed … |
| service_tier | string | – | Optional service tier for compatible video models. service_tier=default is accepted as a compatibil… |
| size | string | – | Model-specific size tier for compatible video models. |
| start_image | string | – | First frame image input for start-end-to-video flows. Seedance accepts a public image reference or … |
| task_id | string | – | Task identifier used by some continuation, extension, or derivative flows. |
| user | string | – | End-user identifier |
| video_url | string | – | Publicly reachable video URL for video-to-video style flows and motion-control models. |
| video_urls | array | – | Compatibility array for video-conditioned flows when multiple input videos are supported by the rou… |
| watermark | boolean | – | Optional watermark toggle for models that expose it. Seedance defaults to false when omitted. |
No output schema declared.
No examples provided.
delete_file Delete file ~93
Delete file Deletes a batch file or a bound image/reference file. When the request includes anthropic-beta: files-api-2025-04-14, the route uses Anthropic Files API mode for the bound workspace.
| Name | Type | Req | Description |
|---|---|---|---|
| anthropic-beta | string | – | Include files-api-2025-04-14 to use Anthropic Files API mode. |
| file_id | string | yes | File ID returned by the Files API. |
No output schema declared.
No examples provided.
edit_image Edit image ~315
Edit image Edits an image using multipart image uploads, JSON image URLs, or the official JSON images array for supported GPT Image models.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| aspect_ratio | string | – | – |
| async | boolean | – | Return a task before the edited image is ready for models that support public async execution. |
| background | string | – | – |
| compression | integer | – | – |
| image_url | string | – | Single source image URL. Kept for TokenLab compatibility; use images for the official JSON shape. |
| image_urls | array | – | Multiple source image URLs. GPT Image edits accept up to 16 source images; xAI Grok Imagine edit mo… |
| images | array | – | Official JSON image references for image edits. Provide exactly one of image_url or file_id for eac… |
| mask | object | – | Optional JSON mask reference for image edits. Provide exactly one of image_url or file_id. Multipar… |
| model | string | yes | Model to use for image edits. Send this explicitly. |
| moderation | string | – | – |
| n | integer | – | – |
| output_compression | integer | – | – |
| output_format | string | – | – |
| prompt | string | yes | – |
| quality | string | – | – |
| resolution | string | – | – |
| response_format | string | – | – |
| size | string | – | – |
| user | string | – | – |
No output schema declared.
No examples provided.
edit_image_file Edit image ~256
Edit image Edits an image using multipart image uploads, JSON image URLs, or the official JSON images array for supported GPT Image models.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| aspect_ratio | string | – | – |
| async | boolean | – | – |
| background | string | – | – |
| compression | integer | – | – |
| image | – | – | Source image file(s). Repeat image for multiple source images. GPT Image edits accept up to 16 imag… |
| image[] | array | – | Alternative repeated multipart field name for multiple source images. The same model-specific limit… |
| mask | string | – | Pass local file path. |
| model | string | yes | Model to use for image edits. Send this explicitly, for example gpt-image-2. |
| moderation | string | – | – |
| n | integer | – | – |
| output_compression | integer | – | – |
| output_format | string | – | – |
| prompt | string | yes | – |
| quality | string | – | – |
| resolution | string | – | – |
| response_format | string | – | – |
| size | string | – | – |
| user | string | – | – |
No output schema declared.
No examples provided.
get_api_overview Get TokenLab API Overview ~19
Fetch TokenLab's agent-readable API overview.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_model Get model ~59
Get model Retrieves current model details, including supported operations, request parameters, request endpoints, selector limits, and pricing when available. Non-chat integrations should read these current model-specific request details before creating a request.
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | yes | The model ID |
No output schema declared.
No examples provided.
get_model_pricing Get model pricing ~45
Get model pricing Retrieves pricing-only detail for one model. Use this endpoint for price explanation, not for non-chat request construction.
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | yes | The model ID |
No output schema declared.
No examples provided.
get_pricing List model pricing ~50
List model pricing Returns the public pricing surface for active models, with optional provider and tag filters.
| Name | Type | Req | Description |
|---|---|---|---|
| provider | string | – | Filter by provider ID. |
| tag | string | – | Filter by model tag. |
No output schema declared.
No examples provided.
get_task_status Get async task status ~87
Get async task status Retrieves the status and result of an asynchronous generation task. Prefer the `poll_url` returned by the create response; `/v1/tasks/{id}` is the canonical fixed status endpoint for video, music, and 3D jobs.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The async task ID returned by `id` / `task_id`, or embedded in `poll_url` |
No output schema declared.
No examples provided.
list_files List files ~156
List files
| Name | Type | Req | Description |
|---|---|---|---|
| after | string | – | – |
| after_id | string | – | Anthropic Files cursor. Return files after this public file id. Requires the Anthropic Files beta h… |
| anthropic-beta | string | – | Include files-api-2025-04-14 to use Anthropic Files API mode. |
| before_id | string | – | Anthropic Files cursor. Return files before this public file id. Requires the Anthropic Files beta … |
| limit | integer | – | – |
| purpose | string | – | Optional file purpose filter. batch and batch_output cover Batch API files; user_data and vision co… |
| scope_id | string | – | Reserved Anthropic Files scope cursor. TokenLab currently returns an explicit unsupported error rat… |
No output schema declared.
No examples provided.
list_models List models ~166
List models Lists the currently available models. Use `view=compact` for model selection and `view=full` for the existing OpenAI-compatible discovery shape. Native API calls default to `full`; integrations may choose `compact` as their default. Non-chat recommendations are available through `recommended_for`.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Filter by model category. |
| provider | string | – | Filter by public model provider, for example openai, anthropic, google, or minimax. |
| recommended_for | string | – | Sort supported non-chat models for a task category and include recommendation evidence. |
| tag | string | – | Filter by a public capability tag. |
| view | string | – | Compact model-selection output is the MCP default. Set view to full only when the complete OpenAI-c… |
No output schema declared.
No examples provided.
rerank_documents Rerank documents ~114
Rerank documents Reranks documents by relevance to a query using semantic similarity.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| documents | array | yes | Documents to rerank |
| model | string | yes | Reranker model to use |
| query | string | yes | Query to rank against |
| return_documents | boolean | – | – |
| top_n | integer | – | Number of results to return |
No output schema declared.
No examples provided.
retrieve_file Retrieve file ~45
Retrieve file
| Name | Type | Req | Description |
|---|---|---|---|
| anthropic-beta | string | – | Include files-api-2025-04-14 to use Anthropic Files API mode. |
| file_id | string | yes | – |
No output schema declared.
No examples provided.
retrieve_file_content Retrieve file content ~21
Retrieve file content
| Name | Type | Req | Description |
|---|---|---|---|
| file_id | string | yes | – |
No output schema declared.
No examples provided.
transcribe_audio Create transcription ~153
Create transcription Transcribes audio into text (Speech-to-Text).
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| file | string | yes | Audio file to transcribe Pass local file path. |
| language | string | – | ISO-639-1 language code |
| model | string | yes | Model to use (whisper-1) |
| prompt | string | – | Optional prompt text |
| response_format | string | – | Response format |
| temperature | number | – | Sampling temperature |
| timestamp_granularities | array | – | Timestamp granularity selection. Requires verbose_json output when requesting word-level timestamps. |
No output schema declared.
No examples provided.
translate_audio Translate audio ~92
Translate audio Transcribes audio and translates the result to English.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| file | string | yes | Pass local file path. |
| model | string | – | – |
| prompt | string | – | – |
| response_format | string | – | – |
| temperature | number | – | – |
No output schema declared.
No examples provided.
translate_text Translate text ~101
Translate text Translates text into a target language using the current translation request format.
| Name | Type | Req | Description |
|---|---|---|---|
| X-TokenLab-Delivery-Policy | string | – | Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Veri… |
| mime_type | string | – | – |
| model | string | yes | – |
| source_language | string | – | – |
| target_language | string | yes | – |
| text | string | yes | – |
| user | string | – | – |
No output schema declared.
No examples provided.
upload_file Upload file ~149
Upload file Uploads a TokenLab/OpenAI-compatible batch or image file. With anthropic-beta: files-api-2025-04-14, uploads an Anthropic Files resource without a purpose field and returns Anthropic file metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| anthropic-beta | string | – | Include files-api-2025-04-14 to use Anthropic Files API mode. |
| file | string | yes | Pass local file path. |
| model | string | – | Optional TokenLab extension for image file uploads. Defaults to gpt-image-2 and binds the returned … |
| purpose | string | – | Required in TokenLab/OpenAI-compatible mode: use batch for Batch API JSONL files, or user_data/visi… |
No output schema declared.
No examples provided.
What is the TokenLab MCP Server server?
TokenLab MCP Server is listed in the public MCP registry as io.github.hedging8563/tokenlab. TokenLab MCP server: 31 default and 80 full-profile tools for models, media, tasks, and files. This page covers its npm package (@tokenlabai/mcp-server).
Is the TokenLab MCP Server server safe to use?
TokenLab MCP Server scores 92 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 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 TokenLab MCP Server server expose?
TokenLab MCP Server exposes 31 tools: cancel_task, create_3d_model, create_anthropic_message, create_chat_completion, create_embedding, and 26 more. Their descriptions and schemas cost roughly 6,554 tokens of context every time the server is loaded.
Is the TokenLab MCP Server server still maintained?
TokenLab MCP Server is still listed as active in the MCP registry. We last reached this channel on 20 September 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 TokenLab MCP Server server under?
TokenLab MCP Server declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.