Goal Story MCP Server

Instructions

Implementation Reference

• src/index.ts:514-531 (handler)

  The handler/registration for the 'goalstory_read_one_step' tool. It constructs the API URL `/steps/${id}`, performs a GET request using the shared doRequest helper, and returns the step data as text content.

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

• src/tools.ts:261-268 (schema)

  Tool definition object containing the name, description, and Zod input schema (requires 'id' string). This is used in the server.tool registration.

  export const READ_ONE_STEP_TOOL = {
    name: "goalstory_read_one_step",
    description:
      "Get detailed information about a specific step to support focused discussion and story creation.",
    inputSchema: z.object({
      id: z.string().describe("Unique identifier of the step to retrieve."),
    }),
  };

• src/types.ts:76-78 (schema)

  TypeScript interface defining the input shape for the tool (id: string).

  export interface GoalstoryReadOneStepInput {
    id: string;
  }