Web3 Research MCP

Implementation Reference

• src/tools/researchTools.ts:254-320 (registration)

  Registration of the 'update-status' tool, including input schema and inline handler function that updates the status of a research plan section in storage.

  server.tool(
    "update-status",
    {
      section: z
        .string()
        .describe(
          "Section name to update (e.g., 'projectInfo', 'technicalFundamentals')"
        ),
      status: z
        .enum(["planned", "in_progress", "completed"])
        .describe("New status for the section"),
    },
    async ({
      section,
      status,
    }: {
      section: string;
      status: "planned" | "in_progress" | "completed";
    }) => {
      try {
        const researchPlan = storage.getSection("researchPlan");
        if (!researchPlan || !researchPlan[section]) {
          return {
            isError: true,
            content: [
              {
                type: "text",
                text: `Section '${section}' not found in research plan`,
              },
            ],
          };
        }
  
        const updatedSection = {
          ...researchPlan[section],
          status,
        };
  
        const updatedPlan = {
          ...researchPlan,
          [section]: updatedSection,
        };
  
        storage.updateSection("researchPlan", updatedPlan);
        storage.addLogEntry(`Updated status of ${section} to ${status}`);
  
        return {
          content: [
            {
              type: "text",
              text: `Updated status of '${section}' to '${status}'`,
            },
          ],
        };
      } catch (error) {
        return {
          isError: true,
          content: [
            {
              type: "text",
              text: `Error updating status: ${error}`,
            },
          ],
        };
      }
    }
  );

• src/tools/researchTools.ts:266-319 (handler)

  The handler function for 'update-status' tool. It retrieves the research plan from storage, updates the specified section's status, saves the updated plan back to storage, logs the change, and returns a success message or error.

  async ({
    section,
    status,
  }: {
    section: string;
    status: "planned" | "in_progress" | "completed";
  }) => {
    try {
      const researchPlan = storage.getSection("researchPlan");
      if (!researchPlan || !researchPlan[section]) {
        return {
          isError: true,
          content: [
            {
              type: "text",
              text: `Section '${section}' not found in research plan`,
            },
          ],
        };
      }
  
      const updatedSection = {
        ...researchPlan[section],
        status,
      };
  
      const updatedPlan = {
        ...researchPlan,
        [section]: updatedSection,
      };
  
      storage.updateSection("researchPlan", updatedPlan);
      storage.addLogEntry(`Updated status of ${section} to ${status}`);
  
      return {
        content: [
          {
            type: "text",
            text: `Updated status of '${section}' to '${status}'`,
          },
        ],
      };
    } catch (error) {
      return {
        isError: true,
        content: [
          {
            type: "text",
            text: `Error updating status: ${error}`,
          },
        ],
      };
    }
  }

• src/tools/researchTools.ts:256-265 (schema)

  Zod schema defining the input parameters for the 'update-status' tool: 'section' (string) and 'status' (enum: planned, in_progress, completed).

  {
    section: z
      .string()
      .describe(
        "Section name to update (e.g., 'projectInfo', 'technicalFundamentals')"
      ),
    status: z
      .enum(["planned", "in_progress", "completed"])
      .describe("New status for the section"),
  },

• src/tools/index.ts:5-11 (registration)

  Intermediate registration function that calls registerResearchTools, which includes the 'update-status' tool registration.

  export function registerAllTools(
    server: McpServer,
    storage: ResearchStorage
  ): void {
    registerResearchTools(server, storage);
  }

• src/server.ts:187-187 (registration)

  Final call to register all tools, including 'update-status', on the MCP server instance.

  registerAllTools(server, storage);