Skip to content
MCP server

TokenLab MCP Server

Search model prices, chat and generate images, video and audio via TokenLab

Runs locallyStatus and history
Pricing
Paid
Platforms
CLI, API
Runs
Locally
Version
0.6.48
Listing updated
3 days ago

About TokenLab MCP Server

TokenLab MCP Server is a paid MCP server for design and media. It runs locally on your machine and is started by your AI client.

The pricing question comes first: with the catalog profile, an agent can compare models, capabilities and public prices with no key at all. The core profile adds chat, images, video, music, 3D, speech, file uploads, async task polling, embeddings, rerank and translation, and the full profile adds batches, the Responses API, world generation, library assets and webhook management.

Tool counts are 6 for catalog, 32 for core (the default) and 89 for full. The tool set is generated from TokenLab's public OpenAPI document, and the server is open source.

It uses a prepaid balance with no subscription: top up $5 to $100, the balance never expires, and failed generations are not charged. The site says requests are not used to train models. A hosted read-only catalog is at mcp.tokenlab.sh/mcp.

Install

Run in a terminal

claude mcp add tokenlab --env TOKENLAB_API_KEY='<TOKENLAB_API_KEY>' --env TOKENLAB_MANAGEMENT_TOKEN='<TOKENLAB_MANAGEMENT_TOKEN>' -- npx -y @tokenlabai/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
        "TOKENLAB_MANAGEMENT_TOKEN": "<TOKENLAB_MANAGEMENT_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
        "TOKENLAB_MANAGEMENT_TOKEN": "<TOKENLAB_MANAGEMENT_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "tokenlab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
        "TOKENLAB_MANAGEMENT_TOKEN": "<TOKENLAB_MANAGEMENT_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
        "TOKENLAB_MANAGEMENT_TOKEN": "<TOKENLAB_MANAGEMENT_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": [
        "-y",
        "@tokenlabai/mcp-server"
      ],
      "env": {
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
        "TOKENLAB_MANAGEMENT_TOKEN": "<TOKENLAB_MANAGEMENT_TOKEN>"
      }
    }
  }
}

Configuration

  • TOKENLAB_API_BASEOptional TokenLab API base URL. Defaults to https://api.tokenlab.sh.
  • TOKENLAB_API_KEYOptional TokenLab API key. Required for LLM inference, multimodal generation, async task, embedding, rerank, and translation tools.
  • TOKENLAB_REQUEST_TIMEOUT_MSOptional request timeout in milliseconds. Defaults to 120000.
  • TOKENLAB_MCP_TOOL_PROFILEOptional generated tool profile: catalog, core (default), or full.
  • TOKENLAB_MCP_SCHEMA_MODEOptional tool schema mode: portable, exact, or strict. Defaults to the selected profile's tested mode.
  • TOKENLAB_MCP_MAX_FILE_BYTESOptional maximum local upload size per file. Defaults to 104857600 bytes.
  • TOKENLAB_MCP_INLINE_BYTESOptional maximum response size returned inline. Defaults to 2097152 bytes.
  • TOKENLAB_ARTIFACT_DIROptional local directory for response artifacts that are not returned inline.
  • TOKENLAB_MANAGEMENT_TOKENOptional workspace Management Token (mt-...) for webhook tools in the full profile. Separate from inference API keys; never put it in tool arguments.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

compare_models
Compare models and prices.
get_api_overview
Overview of the TokenLab API.
create_gemini_content
Gemini generateContent request.

What it does

Model and price search
Compares models and prices without a key.
Chat and media
Chat, images, video, music, 3D and audio.
Tool profiles
Choose catalog, core or full to control tool count.
Files and tasks
Upload files and poll async jobs.
Embeddings and translation
Embeddings, rerank and translation tools.
Hosted catalog
Read-only remote endpoint for lookups.

Good for

  • Choose the cheapest model for a task
  • Generate images and video from a coding agent
  • Poll a long video task
  • Embed and rerank documents

Pricing

Paid

Prepaid credits, pay as you go; MCP server itself is free

Prices change. Check tokenlab.sh before you buy.

TokenLab MCP Server FAQ

Do I need an API key?

Not for the catalog profile; core and full need TOKENLAB_API_KEY.

Is there a subscription?

No. It is prepaid credits, deducted per model rate.

Are failed generations charged?

No, per the pricing FAQ.

Is TokenLab MCP Server free?

No. TokenLab MCP Server is a paid product.

How do I add TokenLab MCP Server to Claude Code?

Run this command in your terminal: claude mcp add tokenlab --env TOKENLAB_API_KEY='<TOKENLAB_API_KEY>' --env TOKENLAB_MANAGEMENT_TOKEN='<TOKENLAB_MANAGEMENT_TOKEN>' -- npx -y @tokenlabai/mcp-server

What are the best alternatives to TokenLab MCP Server?

The closest alternatives to TokenLab MCP Server are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to TokenLab MCP Server

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media