rival-mcp

MCP server for querying AI model comparison data from rival.tips

This server lets AI coding assistants — Claude Code, Cursor, Windsurf, and any MCP-compatible client — natively query model benchmarks, pricing, capabilities, and side-by-side comparisons without leaving your editor.

Quick Start

npx rival-mcp

No API key required. All data is served from the public rival.tips API.

Configuration

Claude Code

Add to your .claude/settings.json (project-level) or ~/.claude/settings.json (global):

{
  "mcpServers": {
    "rival": {
      "command": "npx",
      "args": ["-y", "rival-mcp"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "rival": {
      "command": "npx",
      "args": ["-y", "rival-mcp"]
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "rival": {
      "command": "npx",
      "args": ["-y", "rival-mcp"]
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "rival": {
      "command": "npx",
      "args": ["-y", "rival-mcp"]
    }
  }
}

Available Tools

list-models

List all AI models with optional filtering.

Parameters:

Example prompts:

• "List all Anthropic models"
• "Show me free models"
• "What models support vision?"

get-model

Get detailed information about a specific model — benchmarks, pricing, capabilities, unique features, and provider availability.

Parameters:

Example prompts:

• "Get details on claude-3.7-sonnet"
• "What are the benchmarks for gpt-4.1?"

compare-models

Compare 2-3 models side by side — benchmarks, pricing, capabilities, and shared challenges.

Parameters:

Example prompts:

• "Compare GPT-4.1 vs Claude 3.7 Sonnet"
• "How does Gemini 2.5 Pro stack up against GPT-4.1 and Claude Sonnet?"

search-models

Search for models by name, description, or capability when you don't know the exact model ID.

Parameters:

Example prompts:

• "Find models good at coding"
• "Search for cheap reasoning models"

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run the built server
npm start

How It Works

This MCP server communicates over stdio (standard input/output) using the Model Context Protocol. When an AI assistant needs model comparison data, it calls the appropriate tool, which fetches data from the rival.tips public API and returns structured JSON.

The server exposes no resources or prompts —

... View full README on GitHub