---
title: "RunAPI MCP Server — 130+ Modelos de IA para Claude Code, Cursor e VS Code"
url: "https://runapi.ai/pt-BR/mcp.md"
canonical: "https://runapi.ai/pt-BR/mcp"
locale: "pt-BR"
---

# RunAPI MCP Server

Conecte Claude Code, Cursor, VS Code, Windsurf e qualquer host compatível com MCP ao RunAPI — gere imagens, vídeos, música e chame LLMs sem sair do seu editor.

## What Is RunAPI MCP Server?

O RunAPI MCP Server conecta ferramentas de programação compatíveis com MCP à plataforma RunAPI. Permite que seu assistente de IA navegue por 130+ modelos em 18 provedores, inspecione parâmetros de entrada, verifique preços em tempo real, crie tarefas de geração de mídia, monitore o status das tarefas, verifique seu saldo e chame endpoints LLM — tudo de dentro do seu editor. As ferramentas de descoberta funcionam sem API key. Operações autenticadas exigem uma API key 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

### Preciso de uma API key para usar o RunAPI MCP Server?

As ferramentas de descoberta como list_models, get_model_info, list_actions e check_pricing funcionam sem API key. Para criação de tarefas, verificação de saldo e chat com LLMs, você precisa de uma API key gratuita do RunAPI, disponível no dashboard.

### Quais ferramentas de programação são suportadas?

O RunAPI MCP Server funciona com qualquer host compatível com MCP: Claude Code, Codex, Cursor, VS Code (via GitHub Copilot), Windsurf e Roo Code. Também pode ser configurado com qualquer ferramenta que suporte o protocolo MCP.

### Quais modelos de IA posso acessar pelo servidor MCP?

Mais de 130 modelos em 18 provedores e 5 modalidades: geração de imagens (Flux, Nano Banana, GPT Image), geração de vídeo (Kling, Veo, Seedance), criação de música (Suno), áudio (ElevenLabs) e LLMs (Claude, GPT, Gemini, DeepSeek).

### Como instalo o servidor MCP?

Use o comando para o seu 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 e Roo Code usam npx @runapi.ai/mcp init <platform>. Não é necessária instalação global de npm.

### O servidor MCP é gratuito?

O servidor MCP em si é gratuito e de código aberto (Apache 2.0). O uso da API é cobrado pela sua conta RunAPI com preços pay-as-you-go. Sem assinaturas ou gasto mínimo.

### Posso usar o servidor MCP em ambientes de CI ou headless?

Sim. Defina a variável de ambiente RUNAPI_API_KEY e configure o servidor MCP no seu agente ou pipeline de CI. O servidor roda como um processo stdio e não requer navegador ou GUI.

### Quais ferramentas estão disponíveis pelo servidor MCP?

São 8 ferramentas integradas — list_models, get_model_info, list_actions e check_pricing funcionam sem API key. create_task, get_task, check_balance e chat exigem uma API key RunAPI.

### Quanto custa usar o RunAPI pelo servidor MCP?

O servidor MCP em si é gratuito. O uso da API é cobrado por chamada pela sua conta RunAPI, sem assinatura ou gasto mínimo. Gerações com falha não são cobradas.


## Links

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