본문으로 건너뛰기
PleumRouter
Get started

MCP Server

Generate images, video and speech — and query balance, pricing and usage — right inside your AI tools

Connect the official PleumRouter MCP server to any MCP-capable AI tool (such as Claude Code) and ask "what's my balance?", "how much does this model cost?", "my usage this week?" without leaving your editor — and now also "draw this", "make a short video", "read this out loud".

What is this#

MCP is the standard way AI tools connect to external services. This server is stateless — your API key is used per request and never stored server-side. Generated images, videos and audio are kept at stable URLs for 30 days.

Setup#

https://mcp.pleum.ai/mcp

In Claude Code, add it from the terminal with the command below.

bash
export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx

claude mcp add --transport http pleum https://mcp.pleum.ai/mcp \
  --header "Authorization: Bearer $PLEUM_API_KEY"

In other MCP clients, add this entry to mcpServers in the client's settings.

json
{
  "mcpServers": {
    "pleum": {
      "url": "https://mcp.pleum.ai/mcp",
      "headers": { "Authorization": "Bearer plm_xxxxxxxxxxxxxxxx" }
    }
  }
}
Authenticated tools need an API key (starting with plm_) from the dashboard, passed as an Authorization: Bearer header. The key is forwarded upstream without being stored. Generation tools (generate_*) bill usage to that key. On generate_image and generate_video, enhance_prompt is on by default, adding one text-token-rate rewrite — pass false to disable it.

Available tools#

It exposes nine tools:

  • list_models — Search the model catalog (public, no auth)
  • get_model — Model pricing detail incl. per-provider offerings and quantization (public)
  • estimate_cost — Estimate cost from token counts (public)
  • get_credits — Credit balance ( required)
  • get_usage — Usage report by period ( usage:read)
  • generate_image — Image generation — stable 30-day URLs plus the first image inline ( required)
  • generate_video — Submit an async video job — poll with get_job ( required)
  • get_job — Generation job (video/3D/music) status and results ( required)
  • generate_speech — Text-to-speech — inline audio plus a stable URL ( required)

Direct calls#

You can also call it directly with JSON-RPC — handy for scripts and monitoring dashboards.

bash
curl -X POST https://mcp.pleum.ai/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-03-26","capabilities":{},
        "clientInfo":{"name":"curl","version":"0"}}}'
bash
export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx

curl -X POST https://mcp.pleum.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PLEUM_API_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"get_credits","arguments":{}}}'
bash
curl -X POST https://mcp.pleum.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PLEUM_API_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
        "name":"generate_image","arguments":{
          "model":"seedream-5-0-260128",
          "prompt":"a neon-lit alley in the rain, cinematic"}}}'
PreviousTerminal CLI