best-mcp: deterministic read-the-recipe note on schema fetches - #11
Merged
Conversation
Surfacing the workflows cross-link is the client''s job: when a fetched command/query schema document carries `workflows` (0.9.5), or its catalogue entry does (0.9.4 fallback, cached per connection for 5 min), get_command_schema / get_query_schema append a fixed note naming the recipe ids and directing the model to get_workflows with workflow_id. Fetching a schema means the model is one step from acting - this is the one place the pointer must not be missable, and it no longer depends on prose salience or the host forwarding server instructions. Verified over MCP stdio against the prod 0.9.4 endpoint: the note fires on the exact get_command_schema(configure-portfolio) call the failed naive-agent traces made, on query schemas, and on optional-step commands. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Client half of #10 (spec 0.9.5 - the workflows cross-link as the single discoverability mechanism). Targets 2.3.2.
When a fetched schema document carries
workflows(0.9.5) - or its catalogue entry does (0.9.4 fallback, per-connection 5-min cache; a failed catalogue read yields no note, never an error) -get_command_schema/get_query_schemaappend a fixed note naming the recipe ids and directing the model toget_workflowswithworkflow_id. The nudge reaches the model mechanically at the moment it is about to plan, independent of prose salience and of whether the host forwards server instructions.Verified over MCP stdio against prod: the note fires on the exact
get_command_schema(configure-portfolio)call both failed Copilot traces made.tscclean.Release after merge:
LC_ALL=en_US.UTF-8 ./scripts/release-mcp.sh 2.3.2.🤖 Generated with Claude Code