goalstory_destroy_step

Remove a specific step from a goal's action plan by providing its unique identifier to permanently delete it.

Instructions

Remove a specific step from a goal's action plan.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	Unique identifier of the step to be permanently removed.

Implementation Reference

src/index.ts:565-582 (handler)

The handler implementation for the 'goalstory_destroy_step' tool. It constructs the API URL /steps/{id}, performs a DELETE request using the shared doRequest helper, and returns a formatted text response with the result.

server.tool(
  DESTROY_STEP_TOOL.name,
  DESTROY_STEP_TOOL.description,
  DESTROY_STEP_TOOL.inputSchema.shape,
  async (args) => {
    const url = `${GOALSTORY_API_BASE_URL}/steps/${args.id}`;
    const result = await doRequest(url, "DELETE");
    return {
      content: [
        {
          type: "text",
          text: `Step deleted:\n${JSON.stringify(result, null, 2)}`,
        },
      ],
      isError: false,
    };
  },
);

src/tools.ts:303-311 (schema)

Zod input schema, name, and description definition for the 'goalstory_destroy_step' tool, exported and used in the MCP server registration.

export const DESTROY_STEP_TOOL = {
  name: "goalstory_destroy_step",
  description: "Remove a specific step from a goal's action plan.",
  inputSchema: z.object({
    id: z
      .string()
      .describe("Unique identifier of the step to be permanently removed."),
  }),
};

src/types.ts:89-91 (schema)
TypeScript type definition matching the input schema for 'goalstory_destroy_step'.
```
export interface GoalstoryDestroyStepInput {
  id: string;
}
```

src/index.ts:26-43 (registration)

Import of the DESTROY_STEP_TOOL constant used for registration.

  DESTROY_STEP_TOOL,
  GET_STORY_CONTEXT_TOOL,
  READ_CURRENT_FOCUS_TOOL,
  READ_GOALS_TOOL,
  READ_ONE_GOAL_TOOL,
  READ_ONE_STEP_TOOL,
  READ_ONE_STORY_TOOL,
  READ_SCHEDULED_STORIES_TOOL,
  READ_SELF_USER_TOOL,
  READ_STEPS_TOOL,
  READ_STORIES_TOOL,
  SET_STEPS_ORDER_TOOL,
  UPDATE_GOAL_TOOL,
  UPDATE_SCHEDULED_STORY_TOOL,
  UPDATE_SELF_USER_TOOL,
  UPDATE_STEP_NOTES_TOOL,
  UPDATE_STEP_TOOL,
} from "./tools.js";

Goal Story MCP Server