---
title: &quot;Servidor MCP de RunAPI — Más de 130 modelos de IA para Claude Code, Cursor y VS Code&quot;
url: &quot;https://runapi.ai/es/mcp.md&quot;
canonical: &quot;https://runapi.ai/es/mcp&quot;
locale: &quot;es&quot;
---

# RunAPI MCP Server

Conecta Claude Code, Cursor, VS Code, Windsurf y cualquier host compatible con MCP a RunAPI — genera imágenes, vídeos, música y llama a LLMs sin salir de tu editor.

## What Is RunAPI MCP Server?

El servidor MCP de RunAPI conecta herramientas de código compatibles con MCP a la plataforma RunAPI. Permite a tu asistente de IA explorar más de 130 modelos de 18 proveedores, inspeccionar parámetros de entrada, consultar precios en tiempo real, crear tareas de generación multimedia, consultar el estado de las tareas, revisar el saldo de tu cuenta y llamar a endpoints LLM — todo desde tu editor. Las herramientas de descubrimiento no requieren API key. Las operaciones autenticadas requieren una API key de RunAPI.

## Tools

| Tool | Auth | Purpose |
|---|---|---|
| list_models | No | Browse models by modality, service, or action. |
| get_model_info | No | Inspect input params, constraints, and pricing for a model. |
| list_actions | No | Group endpoint action names by output modality. |
| check_pricing | No | Return pricing snapshot for a service + action + model. |
| create_task | Yes | Create a media task and optionally poll until completion. |
| get_task | Yes | Fetch status and latest payload for an existing task. |
| check_balance | Yes | Return account balance and spending metrics. |
| chat | Yes | Send messages to a RunAPI LLM endpoint. |

## Quick Start

Choose the command for your MCP client.

### Claude Code

```bash
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
export RUNAPI_API_KEY="runapi_xxx"
claude
```

Use project scope when you want the repo to share `.mcp.json`:

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

### Codex

```bash
codex plugin install runapi-mcp@agents
export RUNAPI_API_KEY="runapi_xxx"
codex
```

### Cursor

```bash
npx @runapi.ai/mcp init cursor
export RUNAPI_API_KEY="runapi_xxx"
cursor .
```

### Windsurf

```bash
npx @runapi.ai/mcp init windsurf
export RUNAPI_API_KEY="runapi_xxx"
windsurf .
```

### VS Code

```bash
npx @runapi.ai/mcp init vscode
export RUNAPI_API_KEY="runapi_xxx"
code .
```

### Roo Code

```bash
npx @runapi.ai/mcp init roo
export RUNAPI_API_KEY="runapi_xxx"
code .
```

Free catalog tools work without a key.
Set `RUNAPI_API_KEY` for `create_task`, `check_balance`, and `chat`.
For GUI-launched clients, add the variable in the client's environment settings.

## Model Coverage

- **Image** — Flux Kontext, Nano Banana, GPT Image, Seedream, Ideogram, Qwen
- **Video** — Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma
- **Music** — Suno v4 / v4.5 / v5 / v5.5
- **Audio** — ElevenLabs TTS, Sound Effects, STT, Isolation
- **LLM** — Claude, GPT, Gemini, DeepSeek

## FAQ

### ¿Necesito una API key para usar el servidor MCP de RunAPI?

Las herramientas de descubrimiento como list_models, get_model_info, list_actions y check_pricing funcionan sin API key. Para crear tareas, consultar saldo y usar LLMs en chat, necesitas una API key gratuita de RunAPI desde el panel.

### ¿Con qué herramientas de código es compatible?

El servidor MCP de RunAPI funciona con cualquier host compatible con MCP: Claude Code, Codex, Cursor, VS Code (vía GitHub Copilot), Windsurf y Roo Code. También se puede configurar con cualquier herramienta que soporte el protocolo MCP.

### ¿A qué modelos de IA puedo acceder a través del servidor MCP?

Más de 130 modelos de 18 proveedores y 5 modalidades: generación de imágenes (Flux, Nano Banana, GPT Image), generación de vídeo (Kling, Veo, Seedance), creación de música (Suno), audio (ElevenLabs) y LLMs (Claude, GPT, Gemini, DeepSeek).

### ¿Cómo instalo el servidor MCP?

Usa el comando para tu cliente. Claude Code usa claude mcp add runapi -s user -- npx -y @runapi.ai/mcp. Codex usa codex plugin install runapi-mcp@agents. Cursor, Windsurf, VS Code y Roo Code usan npx @runapi.ai/mcp init &lt;platform&gt;. No se requiere instalación global de npm.

### ¿Es gratuito el servidor MCP?

El servidor MCP en sí es gratuito y de código abierto (Apache 2.0). El uso de la API se factura a través de tu cuenta RunAPI con precios de pago por uso. Sin suscripciones ni gasto mínimo.

### ¿Puedo usar el servidor MCP en CI o entornos sin interfaz?

Sí. Define la variable de entorno RUNAPI_API_KEY y configura el servidor MCP en tu agente o pipeline CI. El servidor se ejecuta como proceso stdio y no requiere navegador ni interfaz gráfica.


## Links

- [Model catalog](https://runapi.ai/es/models)
- [CLI](https://runapi.ai/es/cli)
- [SDKs](https://runapi.ai/es/sdk)
- [Skills](https://runapi.ai/es/skills)
- [Pricing](https://runapi.ai/es/pricing)
- [API docs](https://runapi.ai/es/docs)
- [GitHub](https://github.com/runapi-ai/mcp)
- [npm](https://www.npmjs.com/package/@runapi.ai/mcp)
