Skip to content

Tightens the MCP tool surface that agents see and makes hierarchy results bounded and predictable. - #30

Open
gkennos wants to merge 6 commits into
mainfrom
fix/unknown-arguments
Open

gkennos wants to merge 6 commits into
mainfrom
fix/unknown-arguments

Conversation

@gkennos

@gkennos gkennos commented Nov 17, 2026

Copy link
Copy Markdown
Member

Summary

  1. Tool and parameter guidance: rewrite tool and parameter descriptions for the concept-mapping workflow, and corrects and shortens guidance for the text, domain, source-planning, embedding and evaluation tools.
  2. Server instructions: the server sends MCP instructions built from the tools that are actually registered. A section is included only when every tool it names is present (server_instructions.py).
  3. Toolsets: every tool declares one or more toolsets (system, lookup, search, mapping, mapping_advanced, graph, embedding, llm, source, knowledge, semantic, offline). select_tools() supports include and exclude, and exclusion always wins. Plugins can declare their own toolset names. Instructions are gated on the declared tools.
  4. Bounded hierarchy results and read-only annotations:
    • concept_descendants takes limit (default 50, max 500), offset and concept_class_ids, and returns total and truncated. Results are ordered by minimum depth, then concept_id.
    • Descendants, ancestors, nearest-standard-ancestor and hierarchy previews all read stored ancestry (concept_ancestor). Nearest-standard ties abstain rather than picking the first row.
    • concept_mapping_context: descendant_limit is a row count only. It no longer sets the traversal depth, which is a fixed stored-ancestry depth of 3. Ancestor depth and display count are separate parameters, and both scopes report total and truncated.
    • Tools are annotated read-only by default.
  5. Argument validation (5762a6b): a tool call with an argument the tool does not declare returns isError with INVALID_INPUT and a "did you mean" hint, instead of the argument being silently dropped.

Checklist

  • Applied exactly one label (breaking, feature, fix, dependencies, or chore)
  • Tests pass locally (uv run pytest -q)
  • Lint passes (uv run ruff check .)

@gkennos gkennos added the fix label Nov 17, 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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant