streamable-httpMITupdated 2mo ago
Official Model Context Protocol (MCP) server for ModelRunner — run 100+ AI models across image, video, audio, and 3D generation from Claude, Cursor, and any MCP client.
What can you do with ModelRunner?
ModelRunner MCP Server
Official Model Context Protocol (MCP) server for ModelRunner — run 100+ AI models across image, video, audio, and 3D generation from Claude, Cursor, and any MCP client.
- Endpoint:
https://mcp.modelrunner.run/mcp(remote server, Streamable HTTP) - Auth: OAuth 2.1 — your browser authorizes once; no API key is pasted into config
- Registry name:
ai.modelrunner/mcp - Setup guide & full tool reference: modelrunner.ai/mcp
Unlike single-vendor MCP servers, one connection exposes the entire ModelRunner catalog — models from multiple AI providers behind one endpoint and one pay-per-use billing account. Your assistant can search the catalog, inspect a model's input schema, run inference, and get results back as hosted URLs directly in the conversation.
Quick start
Claude Code
claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp
Cursor / VS Code (native remote URL)
{
"mcpServers": {
"modelrunner": { "url": "https://mcp.modelrunner.run/mcp" }
}
}
Claude Desktop or any stdio-only client (via mcp-remote)
{
"mcpServers": {
"modelrunner": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
}
}
}
On first use your AI assistant opens a browser window to sign in to ModelRunner — that's the whole setup.
Tools
| Group | Tools |
|---|---|
| Discover & inspect | search, list_models, list_wrappers, recommended_models, recommended_wrappers, get_model, get_wrapper, get_model_raw_schema, get_wrapper_raw_schema, get_wrapper_prompt_template, get_wrapper_field_mappings |
| Run & fetch | run_model, wait_for_request, get_request, list_my_requests |
| Upload files | create_upload_url, upload_file |
| Author wrappers | wrapper_authoring_guide, create_wrapper, patch_wrapper, preview_wrapper, list_my_wrappers, delete_wrapper |
"Wrappers" are reusable, simplified interfaces you can build over base models — a few friendly inputs, a prompt template, and baked-in settings — and they run through the same run_model-style tools.
Models & capabilities
The catalog covers text-to-image, image-to-image, text-to-video, image-to-video, video-to-video, music generation, speech-to-text, and image-to-3D, including models like Kling, HiDream, Hunyuan Image, Stable Audio, and Rodin. Browse by capability:
- Text-to-Image API · Image-to-Image API
- Text-to-Video API · Image-to-Video API · Video-to-Video API
- Music Generation API · Speech-to-Text API
- Image-to-3D API
Full catalog: modelrunner.ai/models
Pricing
Free to connect. Model runs are pay-per-use from prepaid credits — no subscription. Every model's exact price (per image, per second of video, per megapixel, …) is shown on its model page and on the pricing page.
About this repository
This repository documents the hosted ModelRunner MCP server. The server itself is first-party, run by ModelRunner as a remote MCP endpoint — there is nothing to install or self-host; the configs above are the entire integration.
- Landing page: modelrunner.ai/mcp
- Docs: modelrunner.ai/docs
- Model catalog: modelrunner.ai/models
License
Install
Add ModelRunner to your client. Pick the one you use.
claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcpcodex mcp add modelrunner --url https://mcp.modelrunner.run/mcp{
"mcpServers": {
"modelrunner": {
"url": "https://mcp.modelrunner.run/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"modelrunner": {
"type": "http",
"url": "https://mcp.modelrunner.run/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"modelrunner": {
"url": "https://mcp.modelrunner.run/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"modelrunner": {
"serverUrl": "https://mcp.modelrunner.run/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance22/25
- Trust16/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 56 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.3.0Latest | Aug 10, 2026 |
| 1.2.0 | Jul 23, 2026 |
| 1.1.0 | Jul 9, 2026 |
| 1.0.0 | Jul 6, 2026 |