MCP Server Setup Guide

Overview

routerah-mcp is an npm package that runs as an MCP server over stdio, listed in the MCP registry as com.routerah/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: github.com/0-don/routerah-mcp.

Quick Config

Paste these into the client. Your key auto-fills when signed in.

Base URL: https://api.routerah.app/v1
API Key: YOUR_API_KEY

Compatibility

Step-by-step setup

1. 1
   Get an API key

   Create a key at routerah.app/token. The server reads ROUTERAH_API_KEY. ROUTERAH_BASE_URL is an optional endpoint override.

   bash

   ROUTERAH_API_KEY=YOUR_API_KEY
   ROUTERAH_BASE_URL=https://api.routerah.app

   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 routerah-mcp on first run, so there is nothing to install.

   json

   {
     "mcpServers": {
       "routerah": {
         "command": "npx",
         "args": ["-y", "routerah-mcp"],
         "env": { "ROUTERAH_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 routerah -e ROUTERAH_API_KEY=YOUR_API_KEY -- npx -y routerah-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. 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 here. Paste any model id into the client.

Gotchas

• !Models with the :free suffix cost nothing and are limited to about 1 request per minute each.
• !ROUTERAH_API_KEY is required. Set ROUTERAH_BASE_URL only to point at a different endpoint.
• !Registry-aware MCP clients can install by registry name com.routerah/mcp instead of the npx command.