Skip to content

Development integration

OpenRouter MCP server for Claude, Codex and Cursor

Explore models, usage and credits on OpenRouter. Connect the OpenRouter MCP server to Toolstile once, then choose which of its tools Claude Code, Codex, Cursor and Claude Desktop may use.

Free plan available. Server credentials stay in Toolstile, not in agent configs.

On this page

What your AI apps can do with OpenRouter

  • Compare models and pricing
  • Review usage and credits

OpenRouter MCP tools

17 tools, taken from the publisher's documentation on 29 October 2026. The server decides what it offers and can add or rename tools at any time; after you connect, Toolstile shows the current list.

ToolWhat it does
send-messageSend a message to any model and get its reply (billable)
generate-imageGenerate an image from a text prompt, returned inline (billable)
list-modelsSearch and filter the live model catalog
get-modelGet full details for one model by author/slug
list-model-endpointsShow which providers serve a model, with price, latency and data policy
list-providersList available providers for routing preferences
list-daily-model-rankingsShow the most used and trending models by token volume
list-app-rankingsShow which apps drive the most OpenRouter traffic
get-creditsGet your remaining account credit
get-generationGet cost, token counts and serving provider for a generation
list-benchmarksList third-party model quality scores
list-task-classificationsShow market share of OpenRouter traffic by task type
search-docsSearch the OpenRouter documentation
send-feedbackReport a problem with one of your own generations (writes data)
spawn-ori-evalGet instructions for running a model eval with Ori
install-ori-harnessGet the recipe for installing the Ori harness
pingHealth check to verify the connection

Suggested access for each AI app

The documentation this list comes from doesn't mark OpenRouter's tools as read-only or destructive. Read each tool's description and decide per app before allowing it.

Coding agent in Claude Code or Cursor. Allow the read tools so the agent can look things up without stopping, and require approval for tools that change shared data.

Chat or research app in Claude Desktop. Allow reading and searching. Allow writes only where you want the app to act for you.

Unattended agent, such as a scheduled Codex job. No one is watching the session, so keep it narrow: allow what the job needs, require approval for changes and block the rest.

Blocked tools are removed from the tool list an app sees, so it won't try them. Because rules apply per app, the same OpenRouter connection can be broad in one app and read-only in another, and the credential stays in Toolstile instead of each app's config file.

How it works with Toolstile

  1. Connect once. Add OpenRouter to a workspace (browser sign-in). Toolstile keeps the credential, so no agent config holds it.
  2. Choose access per app. Give Claude Code every OpenRouter tool, give Cursor only the read tools, or keep OpenRouter away from an app entirely.
  3. Share approved accounts. Teammates use the connection without copying tokens, and you can remove access in one place.
  4. Review activity. See which app called which tool and when, so you can tighten access with evidence.

Add the OpenRouter MCP server to an AI app

Through Toolstile, every AI app uses one gateway entry, whichever servers you connect. In Claude Code:

Shell
claude mcp add --transport http toolstile 'https://toolstile.com/mcp'

Then connect OpenRouter in your workspace and choose which of its tools that app may use. Client setup covers Codex, Cursor and Claude Desktop.

To connect directly instead, add the OpenRouter endpoint to each app separately. In Claude Code:

Shell
claude mcp add --transport http openrouter 'https://mcp.openrouter.ai/mcp'

In Cursor's mcp.json:

JSON
{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Some servers accept only clients they have approved, or need a token header. Check the OpenRouter MCP documentation for what your client needs.

Before you connect

An OpenRouter account.

Server details

DetailValue
PublisherOpenRouter
Endpointhttps://mcp.openrouter.ai/mcp
AuthenticationBrowser sign-in
CategoriesDevelopment
Tool list17 tools, observed 29 October 2026 (docs)

OpenRouter MCP documentation