TokenLab MCP Server MCP Server

Name: TokenLab MCP Server MCP Server
Author: io.github.hedging8563

io.github.hedging8563/tokenlab

Repository Registry

What is the TokenLab MCP Server MCP server?

TokenLab MCP server: 31 default and 80 full-profile tools for models, media, tasks, and files.

How to install TokenLab MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

TOKENLAB_API_BASE
Optional TokenLab API base URL. Defaults to https://api.tokenlab.sh.
TOKENLAB_API_KEY
secret
Optional TokenLab API key. Required for LLM inference, multimodal generation, async task, embedding, rerank, and translation tools.
TOKENLAB_REQUEST_TIMEOUT_MS
Optional request timeout in milliseconds. Defaults to 120000.
TOKENLAB_MCP_TOOL_PROFILE
Optional generated tool profile: catalog, core (default), or full.
TOKENLAB_MCP_SCHEMA_MODE
Optional tool schema mode: portable, exact, or strict. Defaults to the selected profile's tested mode.
TOKENLAB_MCP_MAX_FILE_BYTES
Optional maximum local upload size per file. Defaults to 104857600 bytes.
TOKENLAB_MCP_INLINE_BYTES
Optional maximum response size returned inline. Defaults to 2097152 bytes.
TOKENLAB_ARTIFACT_DIR
Optional local directory for response artifacts that are not returned inline.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_BASE": "<YOUR_TOKENLAB_API_BASE>",
        "TOKENLAB_API_KEY": "<YOUR_TOKENLAB_API_KEY>",
        "TOKENLAB_REQUEST_TIMEOUT_MS": "<YOUR_TOKENLAB_REQUEST_TIMEOUT_MS>",
        "TOKENLAB_MCP_TOOL_PROFILE": "<YOUR_TOKENLAB_MCP_TOOL_PROFILE>",
        "TOKENLAB_MCP_SCHEMA_MODE": "<YOUR_TOKENLAB_MCP_SCHEMA_MODE>",
        "TOKENLAB_MCP_MAX_FILE_BYTES": "<YOUR_TOKENLAB_MCP_MAX_FILE_BYTES>",
        "TOKENLAB_MCP_INLINE_BYTES": "<YOUR_TOKENLAB_MCP_INLINE_BYTES>",
        "TOKENLAB_ARTIFACT_DIR": "<YOUR_TOKENLAB_ARTIFACT_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_BASE": "<YOUR_TOKENLAB_API_BASE>",
        "TOKENLAB_API_KEY": "<YOUR_TOKENLAB_API_KEY>",
        "TOKENLAB_REQUEST_TIMEOUT_MS": "<YOUR_TOKENLAB_REQUEST_TIMEOUT_MS>",
        "TOKENLAB_MCP_TOOL_PROFILE": "<YOUR_TOKENLAB_MCP_TOOL_PROFILE>",
        "TOKENLAB_MCP_SCHEMA_MODE": "<YOUR_TOKENLAB_MCP_SCHEMA_MODE>",
        "TOKENLAB_MCP_MAX_FILE_BYTES": "<YOUR_TOKENLAB_MCP_MAX_FILE_BYTES>",
        "TOKENLAB_MCP_INLINE_BYTES": "<YOUR_TOKENLAB_MCP_INLINE_BYTES>",
        "TOKENLAB_ARTIFACT_DIR": "<YOUR_TOKENLAB_ARTIFACT_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_BASE": "<YOUR_TOKENLAB_API_BASE>",
        "TOKENLAB_API_KEY": "<YOUR_TOKENLAB_API_KEY>",
        "TOKENLAB_REQUEST_TIMEOUT_MS": "<YOUR_TOKENLAB_REQUEST_TIMEOUT_MS>",
        "TOKENLAB_MCP_TOOL_PROFILE": "<YOUR_TOKENLAB_MCP_TOOL_PROFILE>",
        "TOKENLAB_MCP_SCHEMA_MODE": "<YOUR_TOKENLAB_MCP_SCHEMA_MODE>",
        "TOKENLAB_MCP_MAX_FILE_BYTES": "<YOUR_TOKENLAB_MCP_MAX_FILE_BYTES>",
        "TOKENLAB_MCP_INLINE_BYTES": "<YOUR_TOKENLAB_MCP_INLINE_BYTES>",
        "TOKENLAB_ARTIFACT_DIR": "<YOUR_TOKENLAB_ARTIFACT_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "tokenlab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_BASE": "<YOUR_TOKENLAB_API_BASE>",
        "TOKENLAB_API_KEY": "<YOUR_TOKENLAB_API_KEY>",
        "TOKENLAB_REQUEST_TIMEOUT_MS": "<YOUR_TOKENLAB_REQUEST_TIMEOUT_MS>",
        "TOKENLAB_MCP_TOOL_PROFILE": "<YOUR_TOKENLAB_MCP_TOOL_PROFILE>",
        "TOKENLAB_MCP_SCHEMA_MODE": "<YOUR_TOKENLAB_MCP_SCHEMA_MODE>",
        "TOKENLAB_MCP_MAX_FILE_BYTES": "<YOUR_TOKENLAB_MCP_MAX_FILE_BYTES>",
        "TOKENLAB_MCP_INLINE_BYTES": "<YOUR_TOKENLAB_MCP_INLINE_BYTES>",
        "TOKENLAB_ARTIFACT_DIR": "<YOUR_TOKENLAB_ARTIFACT_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add tokenlab --env TOKENLAB_API_BASE=<YOUR_TOKENLAB_API_BASE> --env TOKENLAB_API_KEY=<YOUR_TOKENLAB_API_KEY> --env TOKENLAB_REQUEST_TIMEOUT_MS=<YOUR_TOKENLAB_REQUEST_TIMEOUT_MS> --env TOKENLAB_MCP_TOOL_PROFILE=<YOUR_TOKENLAB_MCP_TOOL_PROFILE> --env TOKENLAB_MCP_SCHEMA_MODE=<YOUR_TOKENLAB_MCP_SCHEMA_MODE> --env TOKENLAB_MCP_MAX_FILE_BYTES=<YOUR_TOKENLAB_MCP_MAX_FILE_BYTES> --env TOKENLAB_MCP_INLINE_BYTES=<YOUR_TOKENLAB_MCP_INLINE_BYTES> --env TOKENLAB_ARTIFACT_DIR=<YOUR_TOKENLAB_ARTIFACT_DIR> -- npx -y @tokenlabai/mcp-server