# Stalemodel

> Stalemodel is an open-source MCP server for ai models and llm tooling. Catch outdated AI model IDs in code and look up current LLM prices and limits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/gillmacedo/stalemodel
- **MCP Registry name:** io.github.GillMacedo/stalemodel
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Coding agents often write model IDs from old training data, which leads to errors such as model not found. This tool checks IDs against a live catalog, suggests the newest model in the same family, and reports prices per million tokens and context sizes. It covers Anthropic, OpenAI, Google Gemini, xAI, DeepSeek and Mistral.

It runs as an MCP server over stdio and as a CLI, needs no API key or account, sends no code anywhere and falls back to a bundled snapshot offline. The scan command exits with status 1 on findings, so it can run in CI. Data comes from models.dev, so it can lag providers, and scan only sees quoted IDs.

The README says it needs Node 22.19 or newer, is MIT licensed, was largely generated with Claude Code and has so far only been tested in Claude Code.

## Features

- **Deprecated ID scan:** Finds outdated model names in a file or folder.
- **Model lookup:** Lists models by provider, price, context size or tool support.
- **ID check:** Reports whether IDs are current, deprecated or unknown.
- **Offline snapshot:** Uses a bundled catalog without network access.
- **CI exit code:** scan exits 1 on findings.
- **Claude Code plugin:** Installs as a plugin with a skill.

## Good for

- Fix 'model not found' errors from stale IDs
- Gate pull requests on deprecated model names
- Find the cheapest current model with a 1M context
- Pick the right Claude ID and see its cost

## Install

### Claude Code (Terminal)

```sh
claude mcp add stalemodel -- npx -y stalemodel
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "stalemodel": {
      "command": "npx",
      "args": [
        "-y",
        "stalemodel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "stalemodel": {
      "command": "npx",
      "args": [
        "-y",
        "stalemodel"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "stalemodel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "stalemodel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "stalemodel": {
      "command": "npx",
      "args": [
        "-y",
        "stalemodel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "stalemodel": {
      "command": "npx",
      "args": [
        "-y",
        "stalemodel"
      ]
    }
  }
}
```

## Tools

- `models_check`: Says whether IDs are current, deprecated or unknown and suggests a newer model.
- `models_find`: Lists models by provider, name, price, context size or tool support.
- `models_scan`: Finds outdated IDs in a file or folder, returning locations only.

## FAQ

### Does it need an API key?

No key or account is needed.

### Where does pricing come from?

From models.dev, fetched live with an offline snapshot.

### What are its limits?

Data can lag, and scan misses IDs built at runtime.

### Which providers?

Anthropic, OpenAI, Google, xAI, DeepSeek and Mistral.

### Is Stalemodel free?

Yes. Stalemodel is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add stalemodel -- npx -y stalemodel

### What are the best alternatives to Stalemodel?

The closest alternatives to Stalemodel are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

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