English Français العربية

ModelRunner

Official registry Media and design

Run 100+ AI models — image, video, audio, 3D — through one API with pay-per-use billing.

Source code Website Documentation

What can you do with ModelRunner?

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http modelrunner 'https://mcp.modelrunner.run/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "modelrunner": {
            "type": "http",
            "url": "https://mcp.modelrunner.run/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ModelRunner MCP Server
  2. Quick start
  3. Tools
  4. Models & capabilities
  5. Pricing
  6. About this repository
  7. License

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.

Maintaining an open-source project? ModelRunner gives active open-source projects free monthly API credits — apply at modelrunner.ai/oss-program.

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

GroupTools
Discover & inspectsearch, 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 & fetchrun_model, wait_for_request, get_request, list_my_requests
Upload filescreate_upload_url, upload_file
Author wrapperswrapper_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:

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.

License

MIT

Frequently asked questions

What is ModelRunner?

Run 100+ AI models — image, video, audio, 3D — through one API with pay-per-use billing.

How do I install ModelRunner?

It runs as a remote server. In Claude Code: claude mcp add --transport http modelrunner 'https://mcp.modelrunner.run/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ModelRunner need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is ModelRunner open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ModelRunner?

It is published by modelrunner. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.