# ImageRouter — MCP server on mcp.ai
> Connect your ImageRouter account and use 8 tools for AI content generation straight from your AI agent. Connect with your own API key. Generate images, videos, and text with ImageRouter, inspect credits, validate normal API keys, and discover models. Management-key endpoints are excluded.

By: mcp.ai · official
Page: https://mcp.ai/imagerouter

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_imagerouter?ms=1787295960000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/imagerouter/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/imagerouter/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/imagerouter/skill.md
Postman collection (v2.1): https://mcp.ai/imagerouter/postman.json

## Tools
- imagerouter_create_chat_completion(model: string, tools?: object[], top_p?: number, messages: object[], max_tokens?: integer, temperature?: number, tool_choice?: string|object, response_format?: object, reasoning_effort?: string) — Create a non-streaming OpenAI-compatible chat completion with a paid text model. Call IMAGEROUTER_LIST_MODELS, IMAGEROUTER_GET_MODEL, and IMAGEROUTER_GET_CREDITS first to verify availability, context,
- imagerouter_create_response(text?: object, input: string|object[], model: string, tools?: object[], top_p?: number, reasoning?: object, temperature?: number, tool_choice?: string|object, instructions?: string, max_output_tokens?: integer) — Create a non-streaming OpenAI Responses API result from plain text or structured multimodal input with a selected ImageRouter text model. Call IMAGEROUTER_LIST_MODELS and IMAGEROUTER_GET_CREDITS first
- imagerouter_edit_image(size?: string, masks?: string[], model: string, images: string[], prompt: string, quality?: string, output_format?: string, response_format?: string) — Transform or inpaint one or more existing images supplied as URLs or data URIs. Call IMAGEROUTER_LIST_MODELS and inspect the selected model first to verify image and optional mask input support, accep
- imagerouter_generate_image(size?: string, model: string, prompt: string, quality?: string, output_format?: string, response_format?: string) — Generate an image from a text prompt with a selected ImageRouter model. Call IMAGEROUTER_LIST_MODELS and inspect the selected model first because pricing, supported sizes and quality levels, and fundi
- imagerouter_generate_video(size?: string, model: string, images?: string[], prompt: string, quality?: string, seconds?: integer, response_format?: string) — Generate a video from text and optional URL or data-URI image inputs. Call IMAGEROUTER_LIST_MODELS and inspect the selected model first because pricing, accepted modalities, quality levels, sizes, and
- imagerouter_get_credits(by_api_key?: boolean) — Inspect remaining credits, cumulative usage, deposits, and optional per-key usage before making potentially paid generation calls.
- imagerouter_get_model(model_id: string) — Get current capabilities, accepted parameters, and pricing for one exact ImageRouter model ID before generation.
- imagerouter_list_models(free?: boolean, name?: string, sort?: string, limit?: integer, fields?: string, provider?: string, input_modality?: string, output_modality?: string) — Discover current ImageRouter model IDs, modalities, supported parameters, and pricing before generation. Filters may be combined. limit truncates results and cannot be continued; omit it for an exhaus

## Example prompts
- "What can I do in ImageRouter?"
- "Show me a summary of my ImageRouter account"

## Links
Docs: https://mcp.ai/docs/mcps/imagerouter
Website: https://mcp.ai/mcps/imagerouter