# Driftline

> Driftline is a freemium MCP server for ai models and llm tooling. Checks OpenAI, Anthropic and Google model IDs for retirement dates before agents use them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://aidriftline.com/agents/
- **Repository:** https://github.com/ai-driftline/driftline
- **MCP Registry name:** io.github.AI-Driftline/driftline
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-14

## About

Coding agents often write model IDs from training data, and many of those models are already retired or about to be. Driftline scans a repository and reports each ID with status (retired, at-risk, deprecated, active or unknown), retirement date, replacement and whether the provider silently routes calls to another model after that date. Exit code 1 means a retired model is in use.

The tracked list covers 257 model IDs and was checked on 13 November 2026, with daily refreshes from provider pages. As an MCP server it works offline from a bundled copy when the network is down, and needs no key or account. The one-command form is `npx -y @aidriftline/driftline . --json`.

The site suggests pasting a rule into AGENTS.md or CLAUDE.md so agents check before adding a model. A GitHub Action adds PR checks and warnings before each retirement, with prompt drift tests on a Pro plan.

## Features

- **Retirement status:** Reports retired, at-risk, deprecated, active or unknown per ID.
- **Replacement and routing:** Names the replacement and flags silent routing to another model.
- **Project scan:** Lists IDs in a folder with file and line.
- **No key needed:** Runs without an account or API key.
- **Offline fallback:** Uses a bundled list when offline.
- **CI option:** A GitHub Action checks every pull request.

## Good for

- Stop an agent from introducing a retired model
- Find models in a repo that retire soon
- Plan migrations ahead of provider deadlines
- Fail a pull request that uses a retired ID

## Install

### Claude Code (Terminal)

```sh
claude mcp add driftline -- npx -y @aidriftline/driftline
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "driftline": {
      "command": "npx",
      "args": [
        "-y",
        "@aidriftline/driftline"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "driftline": {
      "command": "npx",
      "args": [
        "-y",
        "@aidriftline/driftline"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "driftline": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aidriftline/driftline"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "driftline": {
      "command": "npx",
      "args": [
        "-y",
        "@aidriftline/driftline"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "driftline": {
      "command": "npx",
      "args": [
        "-y",
        "@aidriftline/driftline"
      ]
    }
  }
}
```

## Tools

- `check_models`: Returns status, retirement date and replacement for a list of model IDs.
- `scan_project`: Finds retired and retiring model IDs in a folder, with file and line.
- `upcoming_retirements`: Lists what retires or gets re-routed in the next N days.

## FAQ

### Does it need an API key?

No, the scan and MCP server need no key or account.

### What does routes: true mean?

The provider forwards requests for that ID to another model after the date.

### How often is data refreshed?

Daily against provider pages.

### Is the GitHub Action free?

The scan is free; drift tests on your prompts need Pro.

### Is Driftline free?

Driftline has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add driftline -- npx -y @aidriftline/driftline

### What are the best alternatives to Driftline?

The closest alternatives to Driftline are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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