Skip to content

docs(mcp): do not substitute unavailable versions - #2988

Open
fahreddinozcan wants to merge 11 commits into
masterfrom
ctx7-1924-mcp-latest-version-guidance
Open

fahreddinozcan wants to merge 11 commits into
masterfrom
ctx7-1924-mcp-latest-version-guidance

Conversation

@fahreddinozcan

@fahreddinozcan fahreddinozcan commented Aug 3, 2026 •

Copy link
Copy Markdown
Collaborator

Prevents agents from silently substituting another documentation version when the user requests one that Context7 has not parsed.

  • Keeps the existing “List of versions if available” guidance.
  • Adds one rule to MCP and pi query tools: if an explicitly requested version is unavailable, report that and do not retry with a different or unversioned library ID.
  • Applies the same rule to the Context7 CLI reference and find-docs skill.

This PR does not claim that versions are sorted or that the first listed version is the unversioned default. Merge after upstash/context7app#840.

@linear-code

linear-code Bot commented Aug 3, 2026

Copy link
Copy Markdown

CTX7-1924

The wording asserted that the first entry is the latest release and is served
when no version is given. That is false whenever the first entry is a
manually parsed tag rather than a detected label, and it will stay false for
every library until pinToLatestTag has a writer, because the default entry
still tracks branch HEAD rather than a release.

Keep the ordering guarantee and the advice not to pin unless asked, and say
only what is true: omitting the version returns the most current docs.
@fahreddinozcan fahreddinozcan changed the title docs(mcp): note that versions list newest first and latest is served by default docs(mcp): do not substitute unavailable versions Aug 31, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant