Skip to content

docs: guide agents to schema-first Galaxy tool calls#143

Open
dannon wants to merge 1 commit into
galaxyproject:mainfrom
dannon:docs/galaxy-tool-input-guidance
Open

docs: guide agents to schema-first Galaxy tool calls#143
dannon wants to merge 1 commit into
galaxyproject:mainfrom
dannon:docs/galaxy-tool-input-guidance

Conversation

@dannon
Copy link
Copy Markdown
Member

@dannon dannon commented May 29, 2026

Short addition to the agent gotchas. Before galaxy_run_tool, fetch the tool's parameter schema (galaxy_get_tool_details(..., io_details=True), or the new galaxy_get_tool_input_template) and build inputs to the real parameter names with the right flattened-key notation (section|param, conditional|selector, repeat_0|param). And if a call comes back with an opaque parameter error -- especially Required parameter(s) kwd not provided in request -- treat it as your own input-shape mismatch to fix, not a sign the MCP or the Galaxy version is incompatible.

Pairs with the galaxy-mcp change that enriches those errors at the source; this is the brain-side nudge so models do the schema lookup proactively and read the failure correctly.

…ad the kwd error

Adds a gotchas section so the brain fetches a tool's parameter schema before
galaxy_run_tool and treats the masked 'Required parameter(s) kwd not provided'
error as an input-shape mismatch to fix, not a sign the MCP/Galaxy version is
incompatible. Pairs with the galaxy-mcp enrich-on-failure change.
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