Skip to content

docs(mcp): stage bounded selector contract - #1159

Draft
hmishra2250 wants to merge 4 commits into
mainfrom
codex/stage3-selector-docs
Draft

docs(mcp): stage bounded selector contract#1159
hmishra2250 wants to merge 4 commits into
mainfrom
codex/stage3-selector-docs

Conversation

@hmishra2250

@hmishra2250 hmishra2250 commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

Scope

Documents the planned bounded selector contract from MCP PR #337 (9a53c34921417650610d8e64020d3dc2adb22353) without changing any currently published runtime claim.

  • grammar: one comma-separated ?tools= parameter, limits, and errors
  • immutable @core-v1 and @full-v1 behavior
  • intersection-only/no-elevation guarantee
  • request-scoped, stateless reconnect/default behavior
  • account and fixed-profile selector inertness, without publishing a search endpoint URL or setup guide

Explicit release hold

Draft only — do not merge or publish yet. This documentation must remain held until all of the following are complete:

  1. MCP docs(locadex): update translations on main #337’s exact candidate passes the required AX no-drop/matrix evaluation.
  2. The selected MCP contract is reviewed and deployed.
  3. The deployed profile has passed its runtime and backward-compatibility verification.
  4. Owner review approves removing or updating the temporary availability warning.

This PR does not enable selectors, change MCP configuration, or expose the Stage-2 search connection flow.

Validation

  • git diff --check origin/main...HEAD
  • docs.json JSON parse
  • static contract assertions for all documented selector grammar, errors, stateless/reconnect behavior, and inert surfaces
  • checked that no /v2/mcp-search URL or account-selector setup URL was introduced

Source of truth

MCP #337 head 9a53c34921417650610d8e64020d3dc2adb22353 only. Older docs PR #1137 was used only as prose inspiration and is not a dependency.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

@mintlify

mintlify Bot commented Jul 26, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
firecrawl 🟢 Ready View Preview Jul 26, 2026, 11:02 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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