Skip to main content
Glama

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-mcp

Use project scope when the server should be shared with a repository:

claude mcp add qwen-2 -s project -- npx -y @runapi.ai/qwen-2-mcp

Codex, 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

edit_image

Yes

Create a Qwen 2 edit image task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

text_to_image

Yes

Create a Qwen 2 text to image task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

get_task

Yes

Fetch the current status and latest payload for an existing task.

check_pricing

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

edit_image

qwen-2-edit-image

text_to_image

qwen-2-text-to-image

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:

  1. RUNAPI_API_KEY environment variable, useful for headless and CI hosts

  2. ~/.config/runapi/config.json, created by the MCP login tool or runapi login

  3. No 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.


Resource

URL

Qwen 2 model page

https://runapi.ai/models/qwen-2

npm package

@runapi.ai/qwen-2-mcp

GitHub repository

runapi-ai/qwen-2-mcp

RunAPI MCP overview

runapi.ai/mcp

RunAPI docs

runapi.ai/docs


License

Licensed under the Apache License, Version 2.0.

Available Tools

5 tools
check_pricingC

Look up RunAPI pricing for the qwen-2 model line.

Inputs: model, action.

edit_imageB

Create a Qwen 2 task on RunAPI (edit image). Returns a task id, status, and output URLs.

Inputs: prompt (required), source_image_url (required), seed, wait, +7 more.

get_taskB

Fetch the current status and latest result payload for a qwen-2 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.

text_to_imageB

Create a Qwen 2 task on RunAPI (text to image). Returns a task id, status, and output URLs.

Inputs: prompt (required), seed, wait, model, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers