Use this reference to choose a package and check the changes that affect an upgrade.
Packages#
| Package | npm package and latest version | Node.js |
|---|---|---|
| CLI | ctx7 | 22 LTS (22.13 or later) or 24 LTS |
| MCP server | @upstash/context7-mcp | 20.18.1 or later |
| TypeScript SDK | @upstash/context7-sdk | Use a maintained Node.js release with built-in fetch |
The CLI package metadata still lists Node.js 18, but current dependencies need a newer runtime. See CLI installation. For release history and upgrade details, see Release Notes.
Related packages: @upstash/context7-tools-ai-sdk (Vercel AI SDK tools) and @upstash/context7-pi (pi.dev extension).
For how queries are stored and used (reranking providers, retention, and enterprise opt-out), see Data Privacy.
Versioning & Migration#
Breaking changes and deprecations to be aware of when upgrading.
SDK — v0.2.0 API simplification#
The SDK API was simplified in 0.2.0:
getDocs()was replaced bygetContext(query, libraryId, options), which takes aqueryfor relevance-based retrievalsearchLibrary(query, libraryName)now takes both a query and a library name- Response types were renamed (
LibraryandDocumentationinstead ofSearchResult,CodeDocsResponse, etc.) - Pagination, mode, topic, and limit options were removed from context retrieval
CLI — research mode removed (v0.4.1)#
Research mode was removed entirely. The query-docs MCP tool no longer accepts or forwards a researchMode parameter, and the CLI no longer exposes a --research flag on ctx7 docs.
CLI — skill commands deprecated#
The ctx7 skills ... commands are deprecated and will stop working in the next major release. The context7-mcp and find-docs skills installed by ctx7 setup are unaffected.