Modelrunner

by modelrunner

366 downloads
Not rated
GitHub Website

About

Official MCP server for ModelRunner — run 100+ AI models (image, video, audio, 3D) from Claude, Cursor & any MCP client. Remote Streamable HTTP + OAuth 2.1.

Details

Author
modelrunner
Downloads
366
Categories
Media, AI, Remote MCP

- One endpoint exposes the entire ModelRunner catalog (100+ models)
- Pay‑per‑use billing with no subscription
- OAuth 2.1 — no API key required in config
- Tools for discovering, inspecting, and running models
- “Wrapper” system for creating reusable simplified model interfaces
- Fully remote server — nothing to install or self‑host

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Modelrunner
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the server via claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp in Claude Code, or set its URL in Cursor/VS Code’s MCP JSON config. For stdio‑only clients like Claude Desktop, use npx -y mcp-remote https://mcp.modelrunner.run/mcp. On first use your AI assistant opens a browser window to sign in — no API key pasting needed.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "modelrunner": {
            "modelrunner": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.modelrunner.run/mcp"
                ]
            }
        }
    }
}

McpServers

{
    "modelrunner": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-remote",
            "https://mcp.modelrunner.run/mcp"
        ]
    }
}

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

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.