stalemap MCP
stalemap finds dependencies that changed after the model training cutoff and gives the agent the current API.
- 110 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Hooks run `npx -y stalemap@latest` and the project type-check after each edit.
- The `sync` command writes a block into `AGENTS.md` or `CLAUDE.md`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/stalemapDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Hooks run `npx -y stalemap@latest` and the project type-check after each edit.
- The `sync` command writes a block into `AGENTS.md` or `CLAUDE.md`.
This is third-party code. Review the repository files before installing.
What it does
An agent writes code for an old API because its training ended before a library release. stalemap compares versions pinned in your project with the model knowledge cutoff: it downloads the type files of both versions, diffs them with the TypeScript compiler and reads release notes and upgrade guides. The result arrives three ways. A short list of changes is written into `AGENTS.md` or `CLAUDE.md`. After each edit a guard runs: the project type-check returns the error to the agent together with the matching note. The `search_changes` tool answers a question in plain words and cites sources.
Who it is for. JavaScript and TypeScript developers whose agent confuses new versions of Next, zod or AI SDK with old ones.
Good fit when
- A project pins a major library version released after the model training cutoff.
- The agent keeps inserting an outdated option, so the type error must reach it at once.
- CI checks that the notes block in `AGENTS.md` is not stale.
- Before upgrading a package the agent looks up changes with a plain-language query.
Not a fit when
- The code is not JavaScript or TypeScript.
- A monorepo with several `package.json` files: workspace traversal is not supported.
- Behaviour changes are not mentioned anywhere in the release notes.
Example request
Show what changed in my dependencies after the model training cutoff and write the notes to `CLAUDE.md`.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Works with JavaScript and TypeScript and a single `package.json`. Packages without bundled types give release-note notes only, `@types/*` are not diffed. Usage tracking stops at imported names and `x.member` accesses. Behaviour changes that never reach a type signature appear only from release notes. The author calls the project early and maintained by one person. Plugin hooks run `npx -y stalemap@latest`, so they use the latest npm release.
How to disable. Run `/plugin uninstall stalemap` and delete the written block from `AGENTS.md` or `CLAUDE.md`.
FAQ
How do I install stalemap in Claude Code?
Run `/plugin marketplace add Umair/stalemap` and `/plugin install stalemap@stalemap`. The plugin adds hooks, the MCP server and two skills: `/stalemap:sync` and `upgrade`.
Which tools does the MCP server expose?
Four: `search_changes`, `package_changes`, `project_changes` and `check_notes`.
How do I use stalemap in CI?
The command `npx stalemap check` exits with code 1 when the notes block is missing or stale. A GitHub Action `Umair/stalemap@main` is available.
Which projects does stalemap work for?
JavaScript and TypeScript projects with a single `package.json`. Monorepo workspace traversal is not supported yet.
Which agents does stalemap work with?
Claude Code, Cursor, Codex, OpenCode and any MCP client.
Discussion
No questions or reviews yet.
Related
MCP serverscodesight maps a project in one run: routes, DB models, dependencies, env vars. It gives the map to an agent as files or through an MCP server
Resolves which files import each other and what an edit will touch, and serves it to agents through hooks, MCP and a CLI
A framework for working with coding agents: a root AGENTS.md, 18 mcaf skills and tests as the decision makers.
Skills for commits, review and ZenTao plus a status line, gateway balance and session logs for Claude Code, Codex, OpenCode.
CLI that builds a codebase index and a 250-token map so an agent does not read hundreds of files to find the right one.
Tasks, docs, specs and decisions live as markdown files in your repository, and the agent reads them through the CLI and MCP
README in short
The project ships as an npm package, a Claude Code plugin, an MCP server and a GitHub Action. The author publishes a blind benchmark of 66 tasks built from post-June 2026 changes, with method and results in `bench/`.