RunAPI Qwen Image MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RunAPI Qwen Image MCP Server Generate an image of a sunset over the ocean."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Why This Package?
@runapi.ai/qwen-image-mcp is a focused Model Context Protocol server for the Qwen Image model line on RunAPI.
It gives MCP-compatible assistants direct access to 3 endpoints and 3 model variants without loading the full RunAPI catalog.
Use this per-model server when an agent should stay scoped to Qwen Image. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.
Related MCP server: Qwen 2 MCP Server
Install
Add it to Claude Code:
claude mcp add qwen-image -s user -- npx -y @runapi.ai/qwen-image-mcpUse project scope when the server should be shared with a repository:
claude mcp add qwen-image -s project -- npx -y @runapi.ai/qwen-image-mcpCodex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:
{
"mcpServers": {
"qwen-image": {
"command": "npx",
"args": ["-y", "@runapi.ai/qwen-image-mcp"]
}
}
}check_pricing works before sign-in. For task creation and status polling, ask your assistant to call the login tool. It opens a browser login and saves credentials to ~/.config/runapi/config.json, the same file used by runapi login.
Headless and CI hosts can still set RUNAPI_API_KEY before starting the MCP host.
Ready-made examples are in examples/ for Claude, Cursor, Windsurf, VS Code, and Roo Code.
Tools
Tool | Auth | Purpose |
| Yes | Create a Qwen Image edit image task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |
| Yes | Create a Qwen Image remix image task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |
| Yes | Create a Qwen Image text to image task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |
| Yes | Fetch the current status and latest payload for an existing task. |
| No | Look up current pricing for a Qwen Image model and endpoint. |
Models
Qwen Image covers 3 model variants across 3 endpoints. Each tool accepts the models listed for it:
Tool | Models |
|
|
|
|
|
|
Model availability can change between releases. Use check_pricing or the Qwen Image model page for the current catalog view.
Agent Prompts
Ask your assistant in natural language; it can inspect pricing, create the task, and return the task id plus output URLs.
Create a task
Run a Qwen Image edit image task with RunAPI.The assistant can call check_pricing, then edit_image, and return the task id, status, and output URLs.
Submit without waiting
Create the task but don't wait for it to finish.The assistant calls the create tool with wait: false and returns the task id. Check on it later with get_task.
Check pricing before creating
Check current Qwen Image pricing, then create the task if it matches my request.The assistant calls check_pricing and can link to the Qwen Image model page for the canonical catalog entry.
Configuration
The server resolves auth in this order:
RUNAPI_API_KEYenvironment variable, useful for headless and CI hosts~/.config/runapi/config.json, created by the MCPlogintool orrunapi loginNo key, which still allows
check_pricing
The config file is normally managed by login. A pre-provisioned headless config can use:
{
"apiKey": "your_runapi_key"
}Do not commit real API keys.
Links
Resource | URL |
Qwen Image model page | |
npm package | |
GitHub repository | |
RunAPI MCP overview | |
RunAPI docs |
License
Licensed under the Apache License, Version 2.0.
Available Tools
6 toolscheck_pricingB
Look up RunAPI pricing for the qwen-image model line.
Inputs: model, action.
edit_imageB
Create a Qwen Image task on RunAPI (edit image). Returns a task id, status, and output URLs.
Inputs: prompt (required), source_image_url (required), seed, wait, +6 more.
get_taskA
Fetch the current status and latest result payload for a qwen-image task.
Inputs: action (required), task_id (required).
loginA
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
Inputs: force.
remix_imageB
Create a Qwen Image task on RunAPI (remix image). Returns a task id, status, and output URLs.
Inputs: prompt (required), source_image_url (required), seed, wait, +6 more.
text_to_imageB
Create a Qwen Image task on RunAPI (text to image). Returns a task id, status, and output URLs.
Inputs: prompt (required), seed, wait, model, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Three generation tools (text_to_image, remix_image, edit_image) share nearly identical descriptions, differing only in a parenthetical mode label, making it hard to distinguish when to use each. get_task, check_pricing, and login are clearly distinct.
All names use snake_case, but most follow a verb_noun pattern while 'login' is a bare verb, creating a minor inconsistency.
Six tools is well-scoped for an image generation API wrapper: three generation modes, task status, pricing, and authentication. Each tool serves a clear purpose without redundancy.
Core workflows (create task, poll status, authenticate, check pricing) are covered, but lifecycle operations like listing tasks or canceling a running task are missing.
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
MCP server for Pixapi: check live credit pricing and balance, then generate images and video.
Generate images with any major model — one API key, one prepaid balance, one MCP.
Create images & video from any MCP agent — 17 models, spend limits, one URL.
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server for GPT-4o Image model line, enabling text-to-image task creation, status polling, and pricing checks via RunAPI.4123 npmApache 2.0
- AlicenseAqualityBmaintenanceEnables image editing, remixing, and text-to-image generation using Qwen 2 models via RunAPI. Supports task polling and pricing checks.5109 npmApache 2.0
- AlicenseBqualityBmaintenanceProvides AI agents with Midjourney API access for image and video generation, task polling, and pricing checks through a focused MCP server.1077 npm2Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to run Flux image generation tasks, poll results, and check pricing through a single MCP server.549 npmApache 2.0