Guide

MCP & CLI

Use eroq inside ChatGPT, Claude, Cursor and coding agents — plus the terminal CLI.

eroq ships a remote Model Context Protocol server at https://eroq.ai/mcp. Connect it to ChatGPT, Claude, Cursor or any MCP client and the generation tools — images, video, speech — appear inside the app. Every call authenticates with your normal API key and spends the same wallet at the same prices; nothing new to meter.

Auth is the key as a Bearer header. Clients that cannot send headers (ChatGPT and Claude custom connectors) use the URL form https://eroq.ai/mcp/<key> — the URL then is the secret: share it with nobody, and revoking the key kills the link. The dashboard's MCP & CLI tab generates a key and writes every snippet for you.

Connect your client

Claude Code

terminal

claude mcp add --transport http eroq https://eroq.ai/mcp \
  --header "Authorization: Bearer eroq_sk_YOUR_KEY"

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "eroq": {
      "url": "https://eroq.ai/mcp",
      "headers": {
        "Authorization": "Bearer eroq_sk_YOUR_KEY"
      }
    }
  }
}

ChatGPT

Settings → Connectors → Create · Authentication: None

https://eroq.ai/mcp/eroq_sk_YOUR_KEY

Claude (web / desktop)

Settings → Connectors → Add custom connector

https://eroq.ai/mcp/eroq_sk_YOUR_KEY

Codex CLI

~/.codex/config.toml

[mcp_servers.eroq]
command = "npx"
args = ["-y", "eroq", "mcp"]
env = { EROQ_API_KEY = "eroq_sk_YOUR_KEY" }

The tools

generate_image

Text-to-image; returns the render URL (or the image itself). Model prices apply.

generate_video

Starts an async render and waits briefly; hand the returned job id to get_video_status.

get_video_status

Free. Polls a render — failed jobs refund themselves.

generate_speech

Text-to-speech MP3. Roster voices, your clones, or char:<id>.

enhance_prompt

Free. Rough draft in, engine-grade image/video prompt out.

list_models

Free. Models, credit prices, plan gates.

list_voices / list_characters / get_account

Free. Voices, your cast, and the wallet.

The CLI

The eroq package (Node 18+, zero dependencies) drives the same API from the terminal, and eroq mcp runs a local stdio MCP server that saves media as files in your working directory — the shape coding agents want. eroq install claude-code (or cursor, codex…) prints the exact connect snippet with your stored key.

terminal

npm install -g eroq
eroq login              # paste a key from /dashboard/developers
eroq image "portrait of a starship mechanic, warm hangar light, 35mm"
eroq video "slow dolly-in on a neon-lit alley in the rain" -s 8 --aspect 9:16
eroq speech "That noise is the reactor again." -v aria
eroq mcp                # stdio MCP server for coding agents

Credits work exactly like the API

Each generation charges its flat credit price before the engine runs and refunds itself if the render fails; free tools are free. An empty wallet answers HTTP 402 — top up on the billing page.