# TokenLab MCP Server

> TokenLab MCP Server is a paid MCP server for design and media. Search model prices, chat and generate images, video and audio via TokenLab. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://tokenlab.sh/mcp
- **Repository:** https://github.com/hedging8563/tokenlab-mcp-server
- **MCP Registry name:** io.github.hedging8563/tokenlab
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/tokenlab-mcp-server
