160+ Models
Access video, image, music, and audio models through one MCP server. No separate provider setup.
Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.
MCP SERVER
AI Models in Your IDE
Connect Claude Code, Cursor, Windsurf, and any MCP-compatible client to 160+ AI models. Generate video, images, music, and audio without leaving your editor.
Compatible with all MCP clients · 160+ models
Install
# Install the MCP server
npx -y @runapi.ai/mcp
# Or add to your MCP config
{
"mcpServers": {
"runapi": {
"command": "npx",
"args": ["-y", "@runapi.ai/mcp"]
}
}
}https://mcp.runapi.ai/mcphttps://mcp.runapi.ai/mcphttps://mcp.runapi.ai/mcphttps://mcp.runapi.ai/mcpAPI Key fallback
Use these configurations only when a client cannot complete OAuth or in a headless environment. Keep the API key in the client's secret mechanism instead of writing it directly into JSON.
{
"mcpServers": {
"runapi": {
"url": "https://mcp.runapi.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:RUNAPI_API_KEY}"
}
}
}
}macOS GUI: Run the command below in Terminal, then fully quit Cursor with Cmd+Q and reopen it from Finder or Dock. Repeat after logging out or restarting macOS. This exposes the key to apps started later in your login session, so use a dedicated revocable key and run `launchctl unsetenv RUNAPI_API_KEY` when you no longer need it.
printf 'RunAPI API key: ' >&2
read -r -s RUNAPI_API_KEY
printf '\n' >&2
launchctl setenv RUNAPI_API_KEY "$RUNAPI_API_KEY"
unset RUNAPI_API_KEY{
"mcpServers": {
"runapi": {
"serverUrl": "https://mcp.runapi.ai/mcp",
"headers": {
"Authorization": "Bearer ${file:~/.config/runapi/mcp_api_key}"
}
}
}
}macOS/Linux: Run the command below once to create a personal mode 600 key file. Save the copied JSON, then fully quit and reopen Windsurf so it rereads the configuration. This avoids an empty GUI environment variable.
install -d -m 700 ~/.config/runapi
umask 077
printf 'RunAPI API key: ' >&2
read -r -s RUNAPI_API_KEY
printf '\n' >&2
printf '%s' "$RUNAPI_API_KEY" > ~/.config/runapi/mcp_api_key
unset RUNAPI_API_KEY
chmod 600 ~/.config/runapi/mcp_api_key{
"inputs": [
{
"type": "promptString",
"id": "runapi-api-key",
"description": "RunAPI API key",
"password": true
}
],
"servers": {
"runapi": {
"type": "http",
"url": "https://mcp.runapi.ai/mcp",
"headers": {
"Authorization": "Bearer ${input:runapi-api-key}"
}
}
}
}160+
Models
4
Modalities
0
Config files
Claude + Cursor
Supported
Works with
-
Claude Code
MCP
-
Codex
MCP
-
Cursor
MCP
-
Windsurf
MCP
-
Gemini CLI
MCP
-
VS Code
Extension
Features
Everything your agent needs
Zero Config
One npx command to install. Auto-discovers your API key from environment or config file.
Structured Output
Every tool returns typed JSON. Your agent parses results without guessing formats.
Async Tasks
Long-running generations (video, music) return a task ID. Poll or wait — the server handles both.
Real-time Pricing
Check model costs before generating. Your agent can make cost-aware decisions.
Open Source
MIT licensed. Inspect the code, contribute, or fork for custom workflows.
HOW IT WORKS
Three Steps to Connect
-
Install
Run npx -y @runapi.ai/mcp in your terminal. The server auto-discovers your API key.
-
Configure
Add the server to your MCP client config. Claude Code, Cursor, and Windsurf all use the same JSON format.
-
Generate
Ask your agent to generate video, images, music, or audio. The MCP server handles the API call and returns structured results.
Quickstart
From Install to Generation in 60 Seconds
# 1. Set your API key
export RUNAPI_API_KEY=your_key_here
# 2. Install MCP server
npx -y @runapi.ai/mcp
# 3. Ask Claude to generate
"Generate a 5-second video of a sunset over the ocean using Kling"{
"mcpServers": {
"runapi": {
"command": "npx",
"args": [
"-y",
"@runapi.ai/mcp"
],
"env": {
"RUNAPI_API_KEY": "your_key"
}
}
}
}What Developers Build
AI-Assisted Content Creation
Let your coding agent generate marketing assets, thumbnails, and social media content directly from your IDE.
Automated Testing
Generate test fixtures — images, audio, and video — programmatically during your test suite.
Multi-Modal Prototyping
Experiment with different AI models side by side. Switch from Kling to Veo to Seedance without leaving your editor.
Why developers choose RunAPI MCP
Zero Configuration
Add one server entry. Claude, Cursor, and Windsurf discover all 160+ models automatically.
Type-Safe Tool Calls
Every model exposes a typed tool schema. Your agent gets validation for free.
Cost Guardrails
Set per-session or per-project spending limits. Agents can't run up surprise bills.
MCP questions
MCP (Model Context Protocol) lets AI coding assistants use external tools. The RunAPI MCP server gives your agent access to 160+ AI models for generating video, images, music, and audio.
Any MCP-compatible client: Claude Code, Cursor, Windsurf, Gemini CLI, and more. VS Code support is available via extension.
No. Use your existing RunAPI API key. The MCP server reads it from your environment or config file.
Yes. The MCP server is MIT licensed and available on GitHub.
The MCP server is free. You pay only the per-token or per-task rate of the models your agent calls, drawn from your RunAPI balance.
Yes. The server speaks standard MCP over stdio or HTTP, so any self-hosted client that implements the protocol can connect.
Building with a team?
We're here to help with enterprise setup, integrations, and technical questions.