Goal Story MCP Server

Instructions

Implementation Reference

• src/index.ts:350-367 (handler)

  The MCP server.tool registration and inline async handler function that executes the tool logic: makes a GET request to the API endpoint `/goals/{id}` using the provided goal ID, retrieves the goal data, and returns it formatted as text content.

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

• src/tools.ts:158-165 (schema)

  Tool specification object including name, description, and Zod input schema definition for validating the 'id' parameter.

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

• src/types.ts:42-44 (schema)

  TypeScript interface defining the input shape for the tool, matching the Zod schema.

  export interface GoalstoryReadOneGoalInput {
    id: string;
  }