# ModelRunner

> ModelRunner is a paid MCP server for design and media. Run image, video, audio, 3D and text models through one hosted MCP, billed per run. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://modelrunner.ai/mcp
- **Repository:** https://github.com/modelrunner/modelrunner-mcp
- **MCP Registry name:** ai.modelrunner/mcp
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

ModelRunner's server turns a catalogue of 215 public models into 23 callable tools, so an assistant can generate media without a separate key for each provider. Sign-in uses OAuth 2.1 with PKCE, nothing is written to disk, and each run is charged from your balance.

Beyond running models, it supports uploading input files and authoring wrappers: reusable, simplified interfaces on top of a model, with tools to create, patch, preview, list and delete them. The listing also notes setup snippets for Claude Code, Claude Desktop, Cursor, VS Code and stdio bridge clients.

The registry entry says 100+ models and the site says 215, so the catalogue figure is the site's.

## Features

- **215-model catalogue:** Image, video, audio, 3D and text models.
- **OAuth 2.1 sign-in:** No API key stored on disk.
- **Reusable wrappers:** Author simplified interfaces on top of models.
- **File uploads:** Upload inputs for models that need them.
- **Per-run billing:** Charges come from your balance.

## Good for

- Generate an image or video from a prompt in an editor
- Compare several models from one config
- Create a reusable template for a recurring generation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.modelrunner.run/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.modelrunner.run/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.modelrunner.run/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.modelrunner.run/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.modelrunner.run/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.modelrunner.run/mcp"
    }
  }
}
```

## Tools

- `search`: Search the catalogue
- `list_models`: List models
- `get_model`: Get a model's details
- `run_model`: Run a model
- `wait_for_request`: Wait for a request to finish
- `get_request`: Fetch a request result
- `list_my_requests`: List your requests
- `create_upload_url`: Create an upload URL
- `upload_file`: Upload a file
- `create_wrapper`: Create a wrapper
- `patch_wrapper`: Patch a wrapper
- `preview_wrapper`: Preview a wrapper
- `delete_wrapper`: Delete a wrapper

## FAQ

### Do I need an API key?

No, sign-in is OAuth and no key is written to disk.

### How is it billed?

Per run from your balance, with no monthly fee.

### How many tools are there?

The site says 23.

### Is ModelRunner free?

No. ModelRunner is a paid product.

### How do I add ModelRunner to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.modelrunner.run/mcp

### What are the best alternatives to ModelRunner?

The closest alternatives to ModelRunner are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/modelrunner
