Runapi MCP

Name: Runapi MCP
Author: runapi-ai

by runapi-aiversion 0.17.0i★ –iComputer or cloud

Registry nameio.github.runapi-builder/runapi-mcp

Install

Overview

Description from the maker (original English)

130+ AI models for image, video, music, and audio — 18 model families, one RunAPI account.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi0 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Design, images & audio
You need to fill in: RUNAPI_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 0 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: RUNAPI_API_KEY

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://mcp.runapi.ai/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http runapi https://mcp.runapi.ai/mcp

Or run it on your computer

claude mcp add runapi --env RUNAPI_API_KEY=your-value -- npx -y @runapi.ai/mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "runapi": {
      "type": "http",
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "runapi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://mcp.runapi.ai/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

RUNAPI_API_KEY secret env
Optional RunAPI API key for headless hosts. Interactive MCP hosts can use the login tool, which writes shared RunAPI config.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

! Caution
Maker matches the repo
The publisher (runapi-builder) is not the repo owner (runapi-ai); someone else may have listed it
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Design, images & audioi

More stars than 0% of the other 2175 servers in this category
Published to the registry more recently than 79% of the other 2175 servers in this category
Basic checks equal to or better than 38% of the other 2175 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Runapi MCP safe?

It passed 0 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: RUNAPI_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.17.0) reached the registry 8 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Figma Context MCP, Claude Real Video, Figma MCP Server

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Figma Context MCP

by GLips

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

Runs on your computer★ 16,165MITUpdated 5 months ago

Install

Claude Real Video

by HUANGCHIHHUNGLeo

Let any LLM watch a video locally — and search everything it has ever watched.

Runs on your computer★ 2,284MITUpdated 2 months ago

Install

Figma MCP Server

by figma

Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.

Runs in the cloud★ 2,152Updated 13 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

RunAPI MCP Server

AI image generation, video generation, music creation, text-to-speech, prompt search, and model discovery — 160+ executable models across 4 modalities in one MCP server.

Works with Claude Code, Codex, Cursor, Windsurf, VS Code, Roo Code, and any MCP-compatible host.

Quick Start | Tools | Examples | Catalog | Platforms

What Is This?

RunAPI MCP Server connects MCP-compatible coding tools to RunAPI. It lets an assistant browse the RunAPI catalog, inspect model inputs, check current runtime pricing, create media tasks, poll task status, and check account balance.

The discovery tools work without an API key because they use the embedded build-time catalog. Authenticated operations use the login tool, runapi login, RUNAPI_API_KEY, or shared RunAPI config.

This package is a pure client. It does not run a local generation backend and only needs RunAPI sign-in for authenticated tools.

Hosted MCP

Remote MCP clients can connect directly to:

https://mcp.runapi.ai/mcp

No Node.js installation is required. Use OAuth when the client supports remote MCP authorization, or configure a RunAPI API key as the bearer credential. See the Hosted MCP setup page for Cursor, Claude Desktop, VS Code, and Windsurf configurations.

Hosted MCP exposes the eight Business Tools documented below. Local Login remains available only in the Local MCP package.

Quick Start

For Local MCP over stdio, install RunAPI with Claude Code's MCP command:

claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

The scope flag controls where the MCP server is stored:

-s user: global, available in all projects for your user.
-s project: team-shared, written to .mcp.json in the current repo so it can be committed.

Use project scope when you want the whole team to share the same server config:

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

Compatibility fallback for non-Claude Code platforms or manual JSON config:

"mcpServers": { "runapi": { "command": "npx", "args": ["-y", "@runapi.ai/mcp"] } } }

If your host needs a generated config file, use the legacy init command as a fallback:

npx @runapi.ai/mcp init claude

npx @runapi.ai/mcp init cursor npx @runapi.ai/mcp init vscode npx @runapi.ai/mcp init windsurf npx @runapi.ai/mcp init roo

Free catalog tools work before sign-in. For task creation, task status, and balance checks, 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.

Tools

Tool	Auth	Purpose
`list_models`	No	List RunAPI models from the embedded catalog. Supports `modality`, `service`, and `action` filters.
`get_model_info`	No	Return service, action, modality, input constraints, and current runtime pricing for a model slug. Use `service` + `action` when a model appears in multiple endpoints.
`list_actions`	No	Group endpoint action names by modality.
`check_pricing`	No	Return current runtime pricing for a `service` + `action` + `model` combination.
`search_prompts`	No	Search reusable prompt examples by `modality`, `category`, `tags`, `q`, `model`, `featured`, and pagination. Each prompt returns `media`: its approved example images, including the cover image of a video prompt. Example videos and reference images are not returned yet.
`login`	No	Start browser login and save RunAPI credentials to shared local config.
`create_task`	Yes	Create a media task with a required caller-generated `idempotency_key`; wait for completion by default or return immediately with `wait: false`.
`get_task`	Yes	Fetch status and latest payload for an existing media task.
`check_balance`	Yes	Return account balance and spending metrics.

The catalog, pricing, and prompt search tools are designed for funnel-top discovery inside coding tools. The task and balance tools are designed for authenticated workflows.

Examples

Ask your assistant natural-language questions. The assistant should use the tools to discover current model slugs and pricing instead of relying on memorized names.

Browse The Catalog

What RunAPI image models are available?

Expected behavior:

The assistant calls list_models with modality: "image".
It summarizes the returned model slugs, services, actions, and required fields.
It avoids quoting stale prices unless it calls check_pricing.

Search Prompt Examples

Find image prompt examples for a logo.

Expected behavior:

The assistant calls search_prompts with modality: "image" and q: "logo".
It summarizes returned titles, prompt text, model slugs, categories, tags, and example image URLs.
It uses the selected prompt with get_model_info before creating a task.

Inspect A Model

Show me the required parameters for this model slug: <model-slug>

Expected behavior:

The assistant calls get_model_info.
If the response is ambiguous, it chooses the relevant service/action from the returned matches and calls get_model_info again with service and action.
It shows required fields, enum constraints, range constraints, conditional input rules, supported action, and current runtime pricing if available.
It tells you to choose another slug with list_models if the slug is not found.

Create A Media Task

Generate a square product image with RunAPI. Pick a suitable image model.

Expected behavior:

The assistant calls list_models to choose a compatible image model.
It calls get_model_info with the selected service/action/model to read the parameter descriptions.
It asks for confirmation if the request is expensive, long-running, or a batch.
It generates one opaque idempotency_key for this logical task and calls create_task.
It returns task ID, status, output URLs, and cost fields when available.

Wait For Completion

Hosted MCP keeps an asynchronous create_task call with wait: true open as request-scoped SSE for up to 300 seconds. It polls about every 5 seconds, sends an SSE heartbeat about every 15 seconds, and sends standard notifications/progress only when the MCP client supplied a progressToken. The terminal JSON-RPC response arrives in that same stream and then closes it.

The terminal tool result includes matching structuredContent and text content with task_id, final status, completed: true, and the RunAPI result. See examples/create-task-and-wait.arguments.json.

Submit Without Waiting

Create the task but do not wait for completion.

Expected behavior:

The assistant generates one opaque idempotency_key and calls create_task with wait: false.
It returns the task ID.
You can later ask for status with get_task.

Replay A Task Creation Safely

create_task requires an opaque idempotency_key from 1 to 512 characters. Generate one new key for each logical task and retain it with the exact service, action, model, and params used for that task.

If the create result is unknown because the connection closed or timed out, do not automatically create another task. Retry only when intended, using the same key with the same input. Reusing the key with different input returns a conflict. Do not derive the key from a JSON-RPC request ID or X-Client-Request-Id.

When Completion Wait reaches its deadline, task creation remains successful. The non-error result has matching structured and text content with task_id, latest status, completed: false, wait_deadline_reached: true, and next_action: "get_task". Continue with get_task; do not create a replacement task.

If polling fails or the connection closes after task creation, the task may still be processing. Continue with get_task; do not create a replacement task.

See examples/create-task.arguments.json for submit-only arguments.

Check Account Balance

Check my RunAPI balance.

Expected behavior:

The assistant calls check_balance.
If no key is configured, it calls login for browser login, or explains RUNAPI_API_KEY for headless hosts.

Catalog Coverage

The MCP Embedded Catalog is generated from RunAPI's contract snapshot. It includes only models executable by this server release.

Modality	What To Use
Image	`list_models` with `modality: "image"`
Video	`list_models` with `modality: "video"`
Audio and music	`list_models` with `modality: "audio"`
Utility	`list_models` with `modality: "utility"`

Catalog contents can change between releases. Use list_models for current service/action/model slugs and get_model_info for each model's current constraints.

Pricing

MiniMax H3 pricing

RunAPI pricing is exposed through the check_pricing tool and the public pricing page. Do not rely on examples in README files for exact prices.

Useful flows:

Call list_models to find a candidate model.
Call check_pricing with service, action, and model.
Show the returned current price or link to runapi.ai/pricing.

Free catalog tools do not create tasks and do not consume account balance.

Platform Setup

Claude Code, Cursor, Windsurf, And VS Code

Run:

claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

Use -s user for a global install available in all projects. Use -s project when you want Claude Code to write .mcp.json in the repo for team-shared config.

Restart or reload your MCP host after changing MCP configuration.

Compatibility Fallback: Generated Config

Use init only when a host needs a platform-specific JSON file or cannot use the Claude Code MCP command.

Claude Code fallback:

npx @runapi.ai/mcp init claude

This writes .mcp.json in the current directory.

Cursor fallback:

npx @runapi.ai/mcp init cursor

This writes .cursor/mcp.json. Open Cursor settings to verify the MCP server is enabled.

VS Code fallback:

npx @runapi.ai/mcp init vscode

This writes .vscode/mcp.json. VS Code uses a top-level servers key and type: "stdio" in generated config.

Windsurf fallback:

npx @runapi.ai/mcp init windsurf

This writes the generated config for the Windsurf target used by the init command.

Roo Code

Run:

npx @runapi.ai/mcp init roo

This writes .roo/mcp.json.

Manual Configuration

Use the example files in examples/ as starting points. Each platform has slightly different wrapper keys and file paths, but all run the same command:

npx -y @runapi.ai/mcp

Configuration

The server reads configuration in this order:

RUNAPI_API_KEY environment variable, useful for headless and CI hosts
`~/.config

Only the beginning is shown; read the rest in the repo

Runapi MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Design, images & audioi

Common questions

Alternatives

Figma Context MCP

Claude Real Video

Figma MCP Server

README from the maker

What Is This?

Hosted MCP

Quick Start

Tools

Examples

Browse The Catalog

Search Prompt Examples

Inspect A Model

Create A Media Task

Wait For Completion

Submit Without Waiting

Replay A Task Creation Safely

Check Account Balance

Catalog Coverage

Pricing

Platform Setup

Claude Code, Cursor, Windsurf, And VS Code

Compatibility Fallback: Generated Config

Roo Code

Manual Configuration

Configuration