Qwen 2 MCP Server
This server provides AI agents with access to Qwen 2 image generation and editing capabilities via the MCP protocol. Here's what you can do:
Generate images from text (
text_to_image): Create a new image from a text prompt, with options for aspect ratio and output format.Edit an image (
edit_image): Submit an image editing task by providing a source image URL and a prompt, with aspect ratio and output format options.Remix an image (
remix_image): Create a remix of an existing image using a source URL and prompt, with support for acceleration levels (none,regular,high) and output format.Check task status (
get_task): Poll or retrieve the current status and result (including output URLs) of any previously created task by its ID.Check pricing (
check_pricing): Look up current pricing for Qwen 2 models and endpoints without requiring an API key.
All task creation tools support an optional waiting/polling mode. The server is compatible with MCP-enabled hosts such as Claude Code, Codex, and Cursor.
Click 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., "@Qwen 2 MCP Servergenerate 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-2-mcp is a focused Model Context Protocol server for the Qwen 2 model line on RunAPI.
It gives MCP-compatible assistants direct access to 2 endpoints and 2 model variants without loading the full RunAPI catalog.
Use this per-model server when an agent should stay scoped to Qwen 2. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.
Related MCP server: grok-imagine-mcp
Install
Add it to Claude Code:
claude mcp add qwen-2 -s user -- npx -y @runapi.ai/qwen-2-mcpUse project scope when the server should be shared with a repository:
claude mcp add qwen-2 -s project -- npx -y @runapi.ai/qwen-2-mcpCodex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:
{
"mcpServers": {
"qwen-2": {
"command": "npx",
"args": ["-y", "@runapi.ai/qwen-2-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 2 edit image task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |
| Yes | Create a Qwen 2 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 2 model and endpoint. |
Models
Qwen 2 covers 2 model variants across 2 endpoints. Each tool accepts the models listed for it:
Tool | Models |
|
|
|
|
Model availability can change between releases. Use check_pricing or the Qwen 2 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 2 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 2 pricing, then create the task if it matches my request.The assistant calls check_pricing and can link to the Qwen 2 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 2 model page | |
npm package | |
GitHub repository | |
RunAPI MCP overview | |
RunAPI docs |
License
Licensed under the Apache License, Version 2.0.
Available Tools
5 toolscheck_pricingC
Look up RunAPI pricing for the qwen-2 model line.
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model slug. Defaults to the line's primary model. | |
| action | No | Endpoint name. Defaults to the endpoint that offers the model. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it does not discharge it. It never says whether pricing is per-token, per-image, or per-request, what currency or unit applies, whether the values are live or cached, or whether authentication is required — all material for a pricing lookup.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no padding, and the verb-resource pairing arrives immediately. It is arguably too terse given the gaps elsewhere, but there is no wasted text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations and no output schema, the description must cover the response shape, and it does not say what the pricing result contains. For a tool whose entire value is the returned pricing unit, omitting that leaves the definition inadequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both the 'model' slug and the 'action' enum are already documented in the schema, making 3 the baseline. The description adds essentially nothing about parameter behavior and arguably narrows the model scope to qwen-2 in a way the open slug parameter does not imply.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('look up') and resource ('RunAPI pricing') with a stated scope ('qwen-2 model line'). It is not confused with any sibling (login, edit_image, text_to_image, get_task), but the scope wording is slightly at odds with the schema, which accepts an arbitrary model slug.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No statement of when to call this versus alternatives, and no prerequisites. An agent can infer it should be checked before invoking edit_image or text_to_image, but the description never says so, and the siblings give no pricing counterpart to route against.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
edit_imageB
Create a Qwen 2 task on RunAPI (edit image). Returns a task id, status, and output URLs.
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Declared type: integer. | |
| wait | No | Poll until the task reaches a terminal status. | |
| model | No | RunAPI model slug for this model line. | |
| prompt | Yes | Declared type: string. | |
| timeout_ms | No | ||
| aspect_ratio | No | Declared type: string. Known values: "1:1", "2:3", "3:2", "3:4", "4:3", "9:16", "16:9", "21:9". | |
| callback_url | No | Declared type: string. | |
| output_format | No | Declared type: string. Known values: "jpeg", "png". | |
| poll_interval_ms | No | ||
| source_image_url | Yes | Declared type: string. | |
| enable_safety_checker | No | Declared type: boolean. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description bears the full burden. It does add useful context by disclosing the asynchronous task model and the return shape (task id, status, output URLs), but it omits auth requirements, cost/pricing implications, rate limits, and what happens if the task times out.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences with the core action front-loaded and the return values stated second. No filler, though the parenthetical '(edit image)' is slightly awkwardly placed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For an 11-parameter task-creation tool with no output schema, the description covers the basic return shape but leaves the async lifecycle (polling vs callback_url, timeout behavior) and operational constraints unexplained. Adequate but with clear gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 82%, above the high-coverage threshold, so the schema already documents parameters like wait, model, aspect_ratio, and output_format. The description adds no parameter meaning beyond that baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific action and resource: creating a Qwen 2 RunAPI task that edits an image. It is clear what the tool does, but it does not distinguish itself from sibling text_to_image or explain why one would pick image editing over generation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance, no prerequisites, and no mention of alternatives such as text_to_image or get_task for retrieving results. The only hint of workflow is the 'wait' parameter defaulting to polling, which lives in the schema, not the description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_taskB
Fetch the current status and latest result payload for a qwen-2 task.
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Asynchronous endpoint the task was created on. | |
| task_id | Yes | Task id returned when the task was created. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It usefully frames the operation as a read returning 'current status' and 'latest result payload', hinting at polling semantics, but says nothing about whether the operation is safe/idempotent, what status values exist, or what the payload looks like while a task is still pending.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with zero filler; the core action and payload are stated immediately.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, so the description must carry some of the return-value burden, and it partially does by naming status and result payload. It still omits lifecycle detail (pending vs. complete states, empty payload behavior) needed to use this status tool correctly in a polling loop.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with both parameters well described, so the baseline is 3. The description adds essentially no parameter meaning beyond the schema - it never clarifies that action must match the endpoint used at creation time, which is the one non-obvious semantic an agent might get wrong.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (Fetch) and resource (current status and latest result payload for a qwen-2 task), which is more informative than a bare 'get task'. It implicitly contrasts with the sibling creation tools edit_image/text_to_image, but never names them, so an agent must infer the create-then-poll relationship.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for a qwen-2 task' implies this is the polling companion to edit_image/text_to_image, so the use context is inferable. However, there is no explicit statement of when to call it, how often to poll, or what to do instead once the task reaches a terminal state.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
loginA
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Re-run browser login when the current credential comes from the local config file. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden. It discloses the interactive browser flow and the file write side effect (config.json). However, it does not mention that it may overwrite existing credentials or that it could block waiting for user input, though these are implied.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, well-structured sentence that front-loads the action ('Authenticate RunAPI') and provides necessary details without extraneous information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple login tool with one optional parameter and no output schema, the description covers the core purpose and side effect. It lacks an explicit statement that this is a prerequisite for other tools, but that is implied.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (the only parameter 'force' has a description). The tool description adds no additional meaning about parameters beyond the schema, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('Authenticate'), target resource ('RunAPI'), method ('browser PKCE login flow'), and side effect (saving to config.json). It is distinct from sibling tools, none of which relate to authentication.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage (to authenticate RunAPI) but does not explicitly say when to run it (e.g., before other RunAPI tools) or when to use the 'force' parameter. Since there are no alternative auth tools among siblings, 'vs alternatives' is not applicable.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
text_to_imageB
Create a Qwen 2 task on RunAPI (text to image). Returns a task id, status, and output URLs.
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Declared type: integer. | |
| wait | No | Poll until the task reaches a terminal status. | |
| model | No | RunAPI model slug for this model line. | |
| prompt | Yes | Declared type: string. | |
| timeout_ms | No | ||
| aspect_ratio | No | Declared type: string. Known values: "1:1", "3:4", "4:3", "9:16", "16:9". | |
| callback_url | No | Declared type: string. | |
| output_format | No | Declared type: string. Known values: "png", "jpeg". | |
| poll_interval_ms | No | ||
| enable_safety_checker | No | Declared type: boolean. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It does disclose the async task model by stating that a task id, status, and output URLs are returned, which is real behavioral value. However, it omits auth requirements, cost, and the fact that the default wait=true blocks until completion, leaving meaningful gaps for a creation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences with no filler, and the core action is front-loaded before the return contract. Every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 10-parameter tool with no output schema, the description usefully names the return values (task id, status, output URLs), which stands in for the missing output schema. It falls short on polling/wait semantics and authentication, but is otherwise sufficient to call the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 80%, so the schema already documents nearly all 10 parameters. The description adds nothing about seed, aspect_ratio, model, wait, timeout_ms, or callback_url, so it neither compensates for the remaining gap nor enriches the documented ones. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Create a Qwen 2 task on RunAPI') and clarifies the modality with '(text to image)', which separates it from the sibling edit_image. It stops short of explicitly contrasting the two, so the distinction is inferable rather than stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance and no alternatives are named. The mention of a returned task id hints that get_task is the follow-up for polling, but the agent must infer this; nothing tells it when text_to_image is preferable to edit_image.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
v0.2.0- Changed
check_pricing2 fields changed- removed
Input schema / additionalPropertiesRemoved value: -false - removed
Input schema / properties / model / enumRemoved value: -[ - "qwen-2-edit-image", - "qwen-2-text-to-image" -]
- Changed
edit_image14 fields changed- changed
Input schema / additionalPropertiesPrevious value: -falseNew value: +{} - added
Input schema / properties / aspect_ratio / descriptionAdded value: +"Declared type: string. Known values: \"1:1\", \"2:3\", \"3:2\", \"3:4\", \"4:3\", \"9:16\", \"16:9\", \"21:9\"." - removed
Input schema / properties / aspect_ratio / enumRemoved value: -[ - "1:1", - "2:3", - "3:2", - "3:4", - "4:3", - "9:16", - "16:9", - "21:9" -] - added
Input schema / properties / callback_url / descriptionAdded value: +"Declared type: string." - added
Input schema / properties / enable_safety_checker / descriptionAdded value: +"Declared type: boolean." - removed
Input schema / properties / model / enumRemoved value: -[ - "qwen-2-edit-image" -] - added
Input schema / properties / output_format / descriptionAdded value: +"Declared type: string. Known values: \"jpeg\", \"png\"." - removed
Input schema / properties / output_format / enumRemoved value: -[ - "jpeg", - "png" -] - added
Input schema / properties / poll_interval_ms / maximumAdded value: +9007199254740991 - added
Input schema / properties / prompt / descriptionAdded value: +"Declared type: string." - added
Input schema / properties / seed / descriptionAdded value: +"Declared type: integer." - changed
Input schema / properties / seed / typePrevious value: -"number"New value: +"integer" - added
Input schema / properties / source_image_url / descriptionAdded value: +"Declared type: string." - added
Input schema / properties / timeout_ms / maximumAdded value: +9007199254740991
- Changed
get_task1 field changed- removed
Input schema / additionalPropertiesRemoved value: -false
- Changed
text_to_image13 fields changed- changed
Input schema / additionalPropertiesPrevious value: -falseNew value: +{} - added
Input schema / properties / aspect_ratio / descriptionAdded value: +"Declared type: string. Known values: \"1:1\", \"3:4\", \"4:3\", \"9:16\", \"16:9\"." - removed
Input schema / properties / aspect_ratio / enumRemoved value: -[ - "1:1", - "3:4", - "4:3", - "9:16", - "16:9" -] - added
Input schema / properties / callback_url / descriptionAdded value: +"Declared type: string." - added
Input schema / properties / enable_safety_checker / descriptionAdded value: +"Declared type: boolean." - removed
Input schema / properties / model / enumRemoved value: -[ - "qwen-2-text-to-image" -] - added
Input schema / properties / output_format / descriptionAdded value: +"Declared type: string. Known values: \"png\", \"jpeg\"." - removed
Input schema / properties / output_format / enumRemoved value: -[ - "png", - "jpeg" -] - added
Input schema / properties / poll_interval_ms / maximumAdded value: +9007199254740991 - added
Input schema / properties / prompt / descriptionAdded value: +"Declared type: string." - added
Input schema / properties / seed / descriptionAdded value: +"Declared type: integer." - changed
Input schema / properties / seed / typePrevious value: -"number"New value: +"integer" - added
Input schema / properties / timeout_ms / maximumAdded value: +9007199254740991
5 tool updates
v0.1.7- Changed
check_pricing2 fields changed- changed
Input schema / properties / action / enumPrevious value: -[ - "edit_image", - "remix_image", - "text_to_image" -]New value: +[ + "edit_image", + "text_to_image" +] - changed
Input schema / properties / model / enumPrevious value: -[ - "qwen-2-edit-image", - "qwen-2-remix-image", - "qwen-2-text-to-image" -]New value: +[ + "qwen-2-edit-image", + "qwen-2-text-to-image" +]
- Changed
edit_image6 fields changed- added
Input schema / properties / callback_urlAdded value: +{ + "type": "string" +} - added
Input schema / properties / enable_safety_checkerAdded value: +{ + "type": "boolean" +} - added
Input schema / properties / prompt / typeAdded value: +"string" - added
Input schema / properties / seedAdded value: +{ + "type": "number" +} - added
Input schema / properties / source_image_url / typeAdded value: +"string" - added
Input schema / requiredAdded value: +[ + "prompt", + "source_image_url" +]
- Changed
get_task2 fields changed- changed
Input schema / properties / action / descriptionPrevious value: -"Endpoint the task was created on."New value: +"Asynchronous endpoint the task was created on." - changed
Input schema / properties / action / enumPrevious value: -[ - "edit_image", - "remix_image", - "text_to_image" -]New value: +[ + "edit_image", + "text_to_image" +]
- Removed
remix_image - Changed
text_to_image5 fields changed- added
Input schema / properties / callback_urlAdded value: +{ + "type": "string" +} - added
Input schema / properties / enable_safety_checkerAdded value: +{ + "type": "boolean" +} - added
Input schema / properties / prompt / typeAdded value: +"string" - added
Input schema / properties / seedAdded value: +{ + "type": "number" +} - added
Input schema / requiredAdded value: +[ + "prompt" +]
1 tool update
v0.1.6- Added
login
5 tool updates
v0.1.0- First observed
check_pricing - First observed
edit_image - First observed
get_task - First observed
remix_image - First observed
text_to_image
TDQS
Scored across 5 tools
edit_image and text_to_image both 'create a Qwen 2 task' but their names and descriptions clearly separate the two modes; check_pricing, login, and get_task serve distinct purposes. Slight residual overlap in task-creation semantics but overall clear.
check_pricing, edit_image, text_to_image, and get_task follow a clean verb_noun snake_case pattern. Only 'login' is a bare verb, a minor deviation.
Five tools is well-scoped for a single-model API wrapper covering auth, pricing, generation, editing, and status. Each tool earns its place with no redundancy.
Core lifecycle is covered: authenticate, check pricing, create tasks, and poll status. Minor gaps exist (no list-tasks or cancel-task operation), but agents can work around this with task ids.
Maintenance
Related MCP Connectors
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Generate and edit images, create videos, quote credit costs, and retrieve private results.
Create images and videos from prompts, with options for image mixing, reference images, and start/…
Create AI images, video, and audio, quote generation costs, and edit Sequencer projects.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables creating and managing GPT Image tasks (edit and text-to-image) via RunAPI, with options to poll status and check pricing.5245 npmApache 2.0
- AlicenseAqualityAmaintenanceEnables AI image and video generation tasks (text-to-image, image-to-video, edit, upscale, etc.) via RunAPI, with support for polling and pricing lookups.10268 npm1Apache 2.0
- AlicenseBqualityAmaintenanceEnables background removal and upscaling of images using Recraft models via RunAPI, with task polling and pricing lookup.5252 npmApache 2.0
- AlicenseAqualityAmaintenanceEnables text-to-image generation using Z Image models via RunAPI, with task management and pricing lookup.4249 npmApache 2.0