McpServer 'tool' function is deprecated and can be replaced with registerTool
registerTool tool adds more options to document MCP tool
title?: string;
description?: string;
inputSchema?: InputArgs;
outputSchema?: OutputArgs;
annotations?: ToolAnnotations;
_meta?: Record<string, unknown>;
we can do extra mapping from API spec:
title -> endpoint summary
description -> endpoint description
inputSchema -> same as today
outputSchema -> should allow to expose API response and maybe even allow to avoid stringifying response
annotations are also opening interesting options (e.g. mark API as "idempotent" or "destructive") but I don't see how to map it with API in flexible and reusable way
McpServer 'tool' function is deprecated and can be replaced with
registerToolregisterTooltool adds more options to document MCP toolwe can do extra mapping from API spec:
title -> endpoint summary
description -> endpoint description
inputSchema -> same as today
outputSchema -> should allow to expose API response and maybe even allow to avoid stringifying response
annotationsare also opening interesting options (e.g. mark API as "idempotent" or "destructive") but I don't see how to map it with API in flexible and reusable way