migrate-tools

/migrate-tools

Migrates MCP tools from the old pattern to the new standardized pattern using helper functions.

Usage

/migrate-tools <tool-group-path>

Example:

/migrate-tools src/umbraco-api/tools/document-type

Description

This command helps migrate MCP tools from the old manual pattern (direct client calls with JSON.stringify) to the new standardized pattern using helper functions like executeGetApiCall, executeVoidApiCall, and createToolResult.

Old vs New Patterns

DELETE Operations (Void)

Old Pattern:

import { UmbracoManagementClient } from "@umb-management-client";
import { CreateUmbracoTool } from "@/helpers/create-umbraco-tool.js";

const DeleteTool = CreateUmbracoTool(
  "delete-item",
  "Deletes an item",
  schema.shape,
  async ({ id }) => {
    const client = UmbracoManagementClient.getClient();
    await client.deleteById(id);
    return {
      content: [{ type: "text" as const, text: JSON.stringify({ success: true }) }],
    };
  }
);

New Pattern:

import { ToolDefinition } from "types/tool-definition.js";
import { withStandardDecorators, executeVoidApiCall, CAPTURE_RAW_HTTP_RESPONSE } from "@/helpers/mcp/tool-decorators.js";

const DeleteTool = {
  name: "delete-item",
  description: "Deletes an item",
  inputSchema: schema.shape,
  annotations: {
    destructiveHint: true,
  },
  slices: ['delete'],
  handler: (async ({ id }: { id: string }) => {
    return executeVoidApiCall((client) =>
      client.deleteById(id, CAPTURE_RAW_HTTP_RESPONSE)
    );
  }),
} satisfies ToolDefinition<typeof schema.shape>;

export default withStandardDecorators(DeleteTool);

GET Operations (Returns Data)

Old Pattern:

const GetTool = CreateUmbracoTool(
  "get-item",
  "Gets an item",
  schema.shape,
  async ({ id }) => {
    const client = UmbracoManagementClient.getClient();
    const response = await client.getById(id);
    return {
      content: [{ type: "text" as const, text: JSON.stringify(response) }],
    };
  }
);