Skip to content

fix(mcp): preserve operation return docs - #383

Open
bytehello wants to merge 1 commit into
sandbox-quantum:mainfrom
bytehello:fix/348-mcp-return-docs
Open

fix(mcp): preserve operation return docs#383
bytehello wants to merge 1 commit into
sandbox-quantum:mainfrom
bytehello:fix/348-mcp-return-docs

Conversation

@bytehello

Copy link
Copy Markdown

Summary

  • pass each registry operation’s full description explicitly to FastMCP
  • preserve Returns: contracts on the MCP surface without changing generated input schemas
  • add focused coverage comparing the MCP description with the source operation contract

Testing

  • uv run --project core ruff format --check .
  • uv run --project core ruff check .
  • uv run --project core mypy --config-file core/pyproject.toml core/switch_core/ connectors/
  • uv run --project core pytest -c core/pyproject.toml core/tests/switch_core/bridges/agent/test_mcp_tool_surface.py core/tests/switch_core/bridges/agent/api/test_operations.py -q (20 passed)

The full non-integration test command reached 2,145 passing tests; 504 database-backed tests could not initialize because no Docker daemon is available in this environment.

Closes #348

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown

All contributors have signed the CLA. ✅
Posted by the CLA Assistant Lite bot.

@bytehello

Copy link
Copy Markdown
Author

I have read the CLA Document and I hereby sign the CLA

switch-cla-assistant Bot added a commit that referenced this pull request Sep 7, 2026
@bytehello

Copy link
Copy Markdown
Author

recheck

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.

MCP door drops every operation's Returns block, so agents on that path see no documented return shape

1 participant