Model Id Cheatsheet

🚀 Model ID Cheatsheet

Prevent your AI coding agent from hallucinating outdated model names. This MCP server provides any AI assistant with instant access to accurate, up-to-date API model IDs, pricing, and specifications for 107 models across 19 providers.

Built with Go. A single 10MB binary. No external calls. Sub-millisecond responses. Automatically updated daily.

- model = "gpt-4-turbo"           # Hallucinated - doesn't exist anymore
+ model = "gpt-5.3-codex"         # Correct - verified against official docs

- model = "claude-3-opus-20240229" # Deprecated
+ model = "claude-opus-4-6"        # Current - latest Anthropic flagship

🚀 Quick Start

Choose one of the following options. You'll be up and running in less than a minute.

Option A: Claude Code (one command)

claude mcp add --transport sse --scope user model-id-cheatsheet \
  https://universal-model-registry-production.up.railway.app/sse

Verify it works:

claude mcp list
# Should show: model-id-cheatsheet ... Connected

Then start a new Claude Code session and ask: "What's the latest OpenAI model?" - it will use the tools automatically.

Option B: Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "model-id-cheatsheet": {
      "url": "https://universal-model-registry-production.up.railway.app/sse"
    }
  }
}

Restart Cursor to apply the change.

Option C: Windsurf

Add to Settings > MCP Servers (or edit ~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "model-id-cheatsheet": {
      "serverUrl": "https://universal-model-registry-production.up.railway.app/sse"
    }
  }
}

Option D: Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.model-id-cheatsheet]
command = "uvx"
args = ["mcp-proxy", "--transport", "sse", "https://universal-model-registry-production.up.railway.app/sse"]

Option E: OpenCode

Add to ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "model-id-cheatsheet": {
      "type": "remote",
      "url": "https://universal-model-registry-production.up.railway.app/sse"
    }
  }
}

Option F: Any MCP Client

Connect to the SSE endpoint directly (no API key, no auth):

https://universal-model-registry-production.up.railway.app/sse

Or use the Streamable HTTP transport:

https://universal-model-registry-production.up.railway.app/mcp

Verify Your Setup

Once connected, try asking your AI assistant any of the following:

• "What's the correct model ID for Claude Opus 4.6?"
• "Is gpt-4o still available?"
• "Compare gpt-5.2 vs claude-opus-4-6"
• "What's the cheapest model with vision?"

If the agent calls a tool like get_model_info or check_model_status before answering, it's working.

✨ Features

Your AI agent gains 6 tools that it calls automatically before writing any model ID:

Resources

What Happens Under the Hood

1. You ask your agent to write code or answer a model question.
2. The agent automatically calls the appropriate tool (e.g., get_model_info).
3. The server responds in sub-milliseconds with verified data (no external API calls).
4. The agent writes code with the correct, current model ID.

The server instructions tell the agent: "NEVER use a model ID from your training data without verifying it first." This means the agent will always check before writing.

💻 Usage Examples

Basic Usage

Writing an API call:

# You: "Call the OpenAI API with their best coding model"
# Agent calls: get_model_info("gpt-5.4")
response = client.chat.completions.create(
    model="gpt-5.4",  # Verified via model registry
    messages=[...]
)

Catching deprecated models:

# You: "Use gpt-4o for this task"
# Agent calls: check_model_status("gpt-4o")
# Agent: "gpt-4o is deprecated. I'll use gpt-5 instead."
response = client.chat.completions.create(
    model="gpt-5",  # Updated automatically
    messages=[...]
)

Advanced Usage

Finding the cheapest option:

# You: "Use the cheapest model that supports vision"
# Agent calls: list_models(capability="vision", status="current")
response = client.chat.completions.create(
    model="gpt-5-nano",  # $0.05/$0.40 per 1M tokens
    messages=[...]
)

Comparing options:

# You: "Should I use Claude or GPT for this?"
# Agent calls: compare_models(["claude-opus-4-6", "gpt-5.2"])
# Agent gets a side-by-side table and makes a recommendation

🔧 Technical Details

Resource Footprint

A common concern: "Will this slow down my agent or eat tokens?"

For comparison, a single web search costs more tokens than all 6 tool schemas combined.

Covered Models (107 total)

Current Models (79)

Legacy & Deprecated Models (30)

Tracked so your agent can detect outdated model IDs and suggest current replacements:

• OpenAI: gpt-5.3-codex (deprecated), gpt-5.2-codex (deprecated), gpt-5.1-codex-mini (deprecated), o3-pro (deprecated), o3-deep-research (deprecated), o3-mini (legacy), gpt-4.1 (deprecated), gpt-4o (deprecated), gpt-4o-mini (deprecated)
• Anthropic: claude-opus-4-5 (legacy), claude-opus-4-1 (legacy), claude-opus-4-0 (legacy), claude-sonnet-4-0 (legacy), claude-3-7-sonnet-20250219 (deprecated)
• Google: gemini-3-pro-preview (deprecated), gemini-3-pro-image-preview (deprecated), gemini-2.5-flash-lite (deprecated), gemini-2.0-flash-lite (deprecated), gemini-2.0-flash (deprecated)
• xAI: grok-4.1 (deprecated), grok-3 (legacy), grok-3-mini (legacy)
• Mistral: mistral-small-2503 (legacy), codestral-2508 (legacy)
• MiniMax: minimax-m2.1 (legacy), minimax-01 (deprecated)
• Meta: llama-3.3-70b (legacy)
• DeepSeek: deepseek-r1 (legacy), deepseek-v3 (deprecated)
• Zhipu: glm-4.6v (deprecated)

📦 Installation

Self-Hosting

If you prefer to run the server locally instead of using the hosted endpoint:

Option 1: Build from Source (recommended for local use)

Requires Go 1.23+.

git clone https://github.com/aezizhu/universal-model-registry.git
cd universal-model-registry/go-server
go build -o model-id-cheatsheet ./cmd/server

Then add it to Claude Code as a local stdio server (zero latency, no network):

claude mcp add --scope user model-id-cheatsheet -- /path/to/model-id-cheatsheet

Or run in SSE mode for other clients:

MCP_TRANSPORT=sse PORT=8000 ./model-id-cheatsheet
# Endpoint: http://localhost:8000/sse

Option 2: Docker

git clone https://github.com/aezizhu/universal-model-registry.git
cd universal-model-registry
docker build -t model-id-cheatsheet .
docker run -p 8000:8000 model-id-cheatsheet

Your SSE endpoint will be at http://localhost:8000/sse.

Option 3: Deploy to Railway

Or manually:

railway login
railway init
railway up

📚 Documentation

Staying Up to Date

Model data is automatically checked and updated daily at 7 PM Pacific Time -- no human intervention needed.

How it works:

1. Railway cron runs the updater daily, scraping 6 providers' public documentation pages (no API keys needed).
2. Models removed from docs --> auto-deprecated via PR (status changed to "deprecated" in code).
3. New models detected --> GitHub issue created for review.
4. CI runs on the auto-generated PR --> if tests pass --> auto-merged into main.
5. Railway auto-deploys from main.

No provider API keys required. The updater reads publicly available documentation pages to detect model changes. Only GITHUB_TOKEN and GITHUB_REPO are needed for creating PRs and issues.

Security

• Rate limiting: 60 requests/minute per IP.
• Connection limits: Max 5 SSE connections per IP, 100 total.
• Request body limit: 64KB max.
• Input sanitization: All string inputs truncated to safe lengths.
• HTTP hardening: ReadTimeout 15s, ReadHeaderTimeout 5s, IdleTimeout 120s, 64KB max headers.
• Non-root Docker: Containers run as unprivileged user.
• Graceful shutdown: Clean connection draining on SIGINT/SIGTERM.

Tech Stack

• Language: Go 1.23.
• MCP SDK: github.com/modelcontextprotocol/go-sdk v1.3.0 (official).
• Transports: stdio, SSE, Streamable HTTP.
• Binary size: ~10MB.
• Tests: 156 unit tests.
• Security: Per-IP rate limiting, connection limits, input sanitization.
• Deploy: Docker (alpine), Railway.

📄 License

This project is licensed under the MIT License.