MCP Server Setup Guide

Overview

unorouter-mcp is an npm package that runs as an MCP server over stdio and is listed in the official MCP registry as com.unorouter/mcp. It exposes three tools: search_models filters the live catalog and takes a free_only option, get_pricing returns USD list prices per 1M tokens, and chat sends a prompt to any model. Source lives at github.com/0-don/unorouter-mcp.

Quick Config

Drop these values into the client. Your key auto-fills when you are signed in.

Base URL: https://api.unorouter.com/v1
API Key: YOUR_API_KEY

Compatibility

Step-by-step setup

1. 1
   Get an API key

   Create a key at unorouter.com/token. The server reads it from the UNOROUTER_API_KEY environment variable. UNOROUTER_BASE_URL is an optional endpoint override.

   bash

   UNOROUTER_API_KEY=YOUR_API_KEY
   UNOROUTER_BASE_URL=https://api.unorouter.com/v1

   Sign in to auto-fill your API key

2. 2
   Add the server to Claude Desktop

   Add this block to your Claude Desktop config file. npx fetches unorouter-mcp on first run, so there is nothing to install up front.

   json

   {
     "mcpServers": {
       "unorouter": {
         "command": "npx",
         "args": ["-y", "unorouter-mcp"],
         "env": { "UNOROUTER_API_KEY": "YOUR_API_KEY" }
       }
     }
   }

   Sign in to auto-fill your API key

3. 3
   Or register it in Claude Code

   One command registers the server with your key.

   bash

   claude mcp add unorouter -e UNOROUTER_API_KEY=YOUR_API_KEY -- npx -y unorouter-mcp

   Sign in to auto-fill your API key

4. 4
   Use the tools

   Ask your client to find a model, compare prices, or send a prompt to a model. It calls search_models, get_pricing, and chat as needed. Any MCP client that speaks stdio works.

   text

   search_models  filter the live catalog (free_only option)
   get_pricing    USD list prices per 1M tokens
   chat           send a prompt to any model

   Sign in to auto-fill your API key

Recommended models

Free models that work well here. Paste any model id into the client.

Gotchas

• !Models with the :free suffix cost nothing. Expect a rate limit of about 1 request per minute per free model.
• !UNOROUTER_API_KEY is required. Set UNOROUTER_BASE_URL only when you point the server at a different endpoint.
• !Registry-aware MCP clients can install the server by its registry name com.unorouter/mcp instead of the npx command.