stalemap — Claude Code MCP server: what it does, how to install
Flags npm package changes released after an agent's training cutoff. It keeps assistants from writing deprecated API calls in modern JavaScript codebases.
claude mcp add --env STALEMAP_MODEL=<STALEMAP_MODEL> --transport stdio stalemap -- npx -y stalemapWhat stalemap does
Coding models assume APIs match their training cutoff date. When modern repositories pin newer versions, agents generate removed parameters, broken imports, or outdated conventions.
stalemap compares installed dependencies against cutoff dates from models.dev or explicit settings. It exposes MCP tools including search_changes, package_changes, project_changes, and check_notes, while writing summary blocks directly into AGENTS.md or CLAUDE.md.
The utility targets JavaScript and TypeScript projects. For custom model awareness, you must configure the STALEMAP_MODEL environment variable upon registration.
What it helps with
- Stop agents from generating removed methods from newer npm dependencies
- Query recent library API modifications using the search_changes tool
- Export fresh package diff summaries into AGENTS.md or CLAUDE.md
- Surface type discrepancies caused by post-cutoff library updates
Example prompts for the agent
- Check stalemap to see what broke in our zod dependency past your training cutoff
- Run search_changes to find the current syntax for next.config rewrites
- Review package_changes to inspect breaking edits across our dependencies
How to install stalemap
Platform CLI
claude mcp add --env STALEMAP_MODEL=<STALEMAP_MODEL> --transport stdio stalemap -- npx -y stalemapReplace <…> with your own values
Platform CLI
codex mcp add stalemap --env STALEMAP_MODEL=<STALEMAP_MODEL> -- npx -y stalemapReplace <…> with your own values
Config file
{
"mcpServers": {
"stalemap": {
"command": "npx",
"args": [
"-y",
"stalemap"
],
"env": {
"STALEMAP_MODEL": "<STALEMAP_MODEL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"stalemap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"stalemap"
],
"env": {
"STALEMAP_MODEL": "<STALEMAP_MODEL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e STALEMAP_MODEL=<STALEMAP_MODEL> stalemap npx -y stalemapReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about stalemap
How do I install stalemap in Claude Code?
Run claude mcp add stalemap -- npx -y stalemap in your terminal. To specify the target model environment, run claude mcp add --env STALEMAP_MODEL=<STALEMAP_MODEL> --transport stdio stalemap -- npx -y stalemap.
What does stalemap do?
It informs coding assistants about breaking changes and updated types in npm packages published after the model's training date.
What platforms and ecosystems does stalemap support?
It works with JavaScript and TypeScript projects across MCP clients like Claude Code, Cursor, Codex, and GitHub Copilot.
