Skip to main content
Glama
LLMIntel Model Lifecycle

LLMIntel Model Lifecycle

@llmintel/mcp

An MCP server that tells your coding agent whether a model id is safe to use.

LLMs are trained on a snapshot of the world and will confidently write gpt-4-32k into your code long after it stops answering. This server gives the agent a live lookup for whether a model is deprecated and when it stops working. It returns the replacement too. Answers are normalized across OpenAI, Anthropic, Azure AI Foundry, AWS Bedrock, Google, and Cohere, and parsed from each provider's own deprecation pages.

No API key, no signup. The catalog is public.

Add to Cursor Install in VS Code

Install

Add it to any MCP host. The package runs straight from npm via npx.

Cursor

In .cursor/mcp.json:

{
  "mcpServers": {
    "llmintel": {
      "command": "npx",
      "args": ["-y", "@llmintel/mcp"]
    }
  }
}

Claude Code

claude mcp add llmintel -- npx -y @llmintel/mcp

Claude Desktop

Same shape as the Cursor block above, in claude_desktop_config.json.

Hosted endpoint (no install)

The same five tools are served over Streamable HTTP at https://llmintel.ai/v1/mcp. Hosts that take a URL need no Node and no package:

{
  "mcpServers": {
    "llmintel": {
      "url": "https://llmintel.ai/v1/mcp"
    }
  }
}

The endpoint is stateless and read-only. It answers from the same catalog the npm package queries.

Related MCP server: endoflife-mcp

Tools

Tool

Returns

check_model

Whether one model id is safe to use: lifecycle state, the retirement deadline in days, the replacement, and the source link.

list_retiring_models

What breaks in the next 180 days (default; configurable up to 1095). Past-due models are listed first, then upcoming ones soonest-first.

suggest_replacement

The provider's own recommendation for what to move to. Falls back to same-provider active models when none was published.

search_models

Catalog search filtered by provider and lifecycle state.

recent_lifecycle_changes

The change feed across all providers, for questions like "what was deprecated this month".

Example

You: Before we ship this, check the model ids in src/agents/.

The agent calls check_model for each one and gets back:

DO NOT USE — this model is retired; API calls to it fail.

"claude-sonnet-4-20250514" resolves to the tracked model anthropic/claude-sonnet-4-20250514.
Model: claude-sonnet-4-20250514 (anthropic/claude-sonnet-4-20250514)
Provider: anthropic
Lifecycle state: retired — retired; calls fail
Deprecated: 2026-04-14 (105 days ago)
Retirement: 2026-06-15 (43 days ago)

The provider has not named a replacement. Use suggest_replacement for options.
Pricing/limits: $3/1M in · $15/1M out

Source: https://docs.anthropic.com/en/docs/about-claude/model-deprecations
Provider's own term: "Retired"

Deadlines are always given in days, because a model cannot reliably judge whether 2026-07-30 is soon.

Design notes

A failed lookup is never a safety verdict. If the catalog is unreachable, the tool returns an MCP error and says so. An agent that read a network failure as "no deprecation found" would happily ship a retired model id. A model that simply isn't tracked gets the same treatment: it returns "not in the catalog, verify with the provider", never "OK".

Pass whatever string is literally in the code (gpt-4o, anthropic/claude-opus-4-1, azure/gpt-4o) and it resolves to the canonical tracked model.

When the provider's own deprecation notice names a successor, that is what you get. Otherwise the fallback list of same-provider active models is labelled as candidates to evaluate, so an agent can tell the two apart.

Anything past its retirement date is broken now, so it gets its own heading instead of sitting in "retiring soon".

Configuration

Both variables are optional.

Variable

Default

Purpose

LLMINTEL_API_KEY

none

Raises the rate-limit budget. The catalog itself is public, so you do not need this.

LLMINTEL_BASE_URL

https://llmintel.ai

Point at a self-hosted or staging catalog.

Anonymous callers get 30 requests/minute per IP, enough for interactive agent use.

Data provenance

Every record links to the provider page it was parsed from and preserves the provider's verbatim lifecycle term (sourceTerm), so a normalization decision is always auditable. Changes go through a human verification queue before publication. Collector freshness is public at /v1/status.

The same data is available as a plain REST API, also without a key. See llmintel.ai/docs.

Where to find it

Directory

Entry

Official MCP Registry

ai.llmintel/model-lifecycle

Glama

@hivemindunit/llmintel-mcp

Smithery

llmintel/model-lifecycle

npm

@llmintel/mcp

Development

pnpm --filter @llmintel/mcp build
pnpm exec vitest run packages/mcp        # protocol-level tests against a fake catalog

# Drive the built binary against a live catalog
pnpm --filter @llmintel/mcp smoke
LLMINTEL_BASE_URL=http://localhost:3000 pnpm --filter @llmintel/mcp smoke

License

MIT © LLMIntel

Available Tools

5 tools
check_modelCheck a model's lifecycle statusA
Read-only
Inspect

Check whether an LLM model id is safe to use, deprecated, or retired, and what to migrate to. Accepts the exact string used in code (e.g. 'gpt-4o', 'claude-sonnet-4-5-20250929', 'anthropic/claude-opus-4-1'). Call this before writing or changing any hardcoded model id.

Inputs: model (required).

list_retiring_modelsList models retiring soonA
Read-only
Inspect

List tracked models scheduled to retire within a time window, soonest first. Use this to audit a codebase or plan migration work.

Inputs: provider, withinDays.

recent_lifecycle_changesRecent lifecycle changesA
Read-only
Inspect

Lifecycle state changes across all tracked providers, newest first. Use this to answer 'what model deprecations happened recently?'.

Inputs: provider, sinceDays.

search_modelsSearch the model catalogA
Read-only
Inspect

List tracked models, optionally filtered by provider and lifecycle state. Use this to discover what is currently available from a provider.

Inputs: limit, state, provider.

suggest_replacementSuggest a replacement for a modelA
Read-only
Inspect

Given a deprecated or retiring model, return the provider's recommended replacement(s) and, when none is published, active models from the same provider to consider.

Inputs: model (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool serves a distinct purpose: recent changes, model check, retiring list, replacement suggestion, and filtered search. No overlap or confusion.

    Naming Consistency4/5

    Four tools follow verb_noun snake_case pattern (check_model, list_retiring_models, suggest_replacement, search_models), but recent_lifecycle_changes uses an adjective_noun pattern, creating a minor inconsistency.

    Tool Count5/5

    Five tools are well-suited for a model lifecycle server, covering essential queries without being excessive or sparse.

    Completeness5/5

    The tool surface covers key lifecycle needs: checking status, listing retiring models, suggesting replacements, viewing recent changes, and search. No obvious gaps for a read-only information server.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to check software end-of-life dates and support status using the endoflife.date API, providing accurate information on software lifecycle, security status, and upgrade recommendations in real-time.
      5
      8
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Software end-of-life intelligence for AI agents: EOL dates, support timelines and 0-100 upgrade risk scores for 480+ products. Check whether a version is still supported, score its risk, or audit an entire stack.
      5
      194 npm
      MIT