Skip to content

Publish per-tool JSON Schemas at a stable HTTP endpoint #141

Description

@sajeetharan

Motivation

Code-Mode clients (Anthropic, Cloudflare) generate typed wrappers from tool schemas. Exposing schemas at a discoverable HTTP endpoint (rather than only inside tools/list payloads) makes codegen and IDE tooling straightforward.

Proposal

  • GET /mcp/tools → list of { name, summary } for all registered tools
  • GET /mcp/tools/{name}/schema → full JSON Schema for that tool's input + output

Auth model mirrors tools/list (anonymous discovery allowed; no data access).

Acceptance criteria

  • New endpoints in MCPProtocolController (or sibling controller)
  • Integration tests in AzureCosmosDB.MCP.Toolkit.Tests
  • Endpoints referenced from README

Related

Part of the "Code Mode" support umbrella. Enables the TypeScript SDK sample (separate issue).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions