# Openrouter

> Openrouter is a freemium MCP server for ai models and llm tooling. MCP server that lists, looks up and compares OpenRouter LLM prices and context windows. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web, self-hosted
- **Website:** https://pipeworx.io/packs/openrouter
- **Repository:** https://github.com/pipeworx-io/mcp-openrouter
- **MCP Registry name:** io.github.pipeworx-io/openrouter
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

The README says this server wraps the OpenRouter model catalog, covering roughly 340 models with per-token pricing normalized to dollars per million tokens. It is built for agents that need to pick a model by cost, context length or modality without browsing several provider pages.

Three tools are exposed: one lists models with filters for search text, free-only, minimum context and modality, sorted cheapest first by completion price; one returns the full record for a single model id, including prompt and completion pricing, per-request and image costs, supported parameters, tokenizer and knowledge cutoff; and one compares two to five models side by side.

The endpoint is hosted on the Pipeworx gateway and runs over streamable HTTP, or through a local npm stdio bridge. Anonymous use is capped at 50 calls a day, and a free Pipeworx account raises that to 200. The README also notes that the endpoint lists shared gateway meta-tools alongside these three.

## Features

- **Model catalog listing:** Returns about 340 OpenRouter models with normalized pricing, context windows and modality.
- **Filtered search:** Narrows results by search text, free-only status, minimum context length or modality.
- **Single model details:** Fetches pricing, context, parameters, tokenizer and knowledge cutoff for one model id.
- **Side-by-side comparison:** Compares pricing, context and modality across two to five models at once.
- **Keyless access:** The three OpenRouter tools work without an API key; an optional Pipeworx key raises the daily cap.

## Good for

- Checking whether one model is cheaper per token than another before choosing it for an app
- Finding free or low-cost models that meet a minimum context window requirement
- Letting an agent pick a vision-capable model by filtering on modality
- Comparing candidate models' pricing and context limits for a cost estimate

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http openrouter https://gateway.pipeworx.io/openrouter/mcp
```

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

```sh
https://gateway.pipeworx.io/openrouter/mcp
```

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

```json
{
  "mcpServers": {
    "openrouter": {
      "url": "https://gateway.pipeworx.io/openrouter/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "openrouter": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openrouter/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openrouter": {
      "serverUrl": "https://gateway.pipeworx.io/openrouter/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://gateway.pipeworx.io/openrouter/mcp
```

Enter a Name (for example "Openrouter"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "openrouter": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openrouter/mcp"
    }
  }
}
```

## Tools

- `openrouter_list_models`: List LLMs from the OpenRouter catalog with normalized pricing, context windows and modality, with filters.
- `openrouter_get_model`: Get full details for one OpenRouter model by id.
- `openrouter_compare_models`: Side-by-side comparison of pricing, context and modality for 2-5 models.

## FAQ

### Does it need an API key?

The README says the three OpenRouter tools are keyless. An optional Pipeworx API key raises the daily call cap from 50 to 200.

### How many models does the catalog cover?

The listing says about 340 models across all major providers.

### Can I run it locally?

Yes. The npm package @pipeworx/mcp-openrouter runs as a local stdio bridge, but it still forwards calls to the Pipeworx gateway and needs network access.

### Is Openrouter free?

Openrouter has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

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

Run this command in your terminal: claude mcp add --transport http openrouter https://gateway.pipeworx.io/openrouter/mcp

### What are the best alternatives to Openrouter?

The closest alternatives to Openrouter are modelright, Open Weights Index, UnoRouter, Unrestrictable and AI Wave.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [modelright](https://ai-powered.com/mcp/modelright): modelright is an open-source MCP server for ai models and llm tooling.
- [Open Weights Index](https://ai-powered.com/mcp/open-weights-index): Open Weights Index is an MCP server for ai models and llm tooling.
- [UnoRouter](https://ai-powered.com/mcp/unorouter): UnoRouter is a freemium MCP server for ai models and llm tooling.
- [Unrestrictable](https://ai-powered.com/mcp/unrestrictable): Unrestrictable is a paid MCP server for ai models and llm tooling.
- [AI Wave](https://ai-powered.com/mcp/ai-wave): AI Wave is a free MCP server for design and media.
- [Modelprice](https://ai-powered.com/mcp/modelprice): Modelprice is an open-source MCP server for ai models and llm tooling.
- [UncensoredLLM](https://ai-powered.com/mcp/uncensoredllm): UncensoredLLM is a freemium MCP server for ai models and llm tooling.
- [Zerouter](https://ai-powered.com/mcp/zerouter): Zerouter is a paid MCP server for ai models and llm tooling.

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