Aptos NPM MCP

Instructions

Implementation Reference

• src/server.ts:92-105 (handler)

  Registration and handler implementation for list_aptos_resources tool.

  server.addTool({
    description:
      "Get a list of all available Aptos development resources. Use this first to see what guidance is available, then use get_specific_aptos_resource to fetch the relevant one.",
    execute: async () => {
      const availableFiles = getAvailableHowToResources();
  
      return {
        text: `Available Aptos development resources:\n${availableFiles.map((f) => `- ${f}`).join("\n")}\n\nUse get_specific_aptos_resource with the exact filename to retrieve content.`,
        type: "text",
      };
    },
    name: "list_aptos_resources",
    parameters: z.object({}),
  });

• src/utils/index.ts:13-24 (helper)

  Helper function used by list_aptos_resources to retrieve available markdown resources.

  export const getAvailableHowToResources = () => {
    try {
      const howToDir = pathJoin(resourcesDir, "how_to");
      const files = fs.readdirSync(howToDir);
      return files
        .filter((file) => extname(file).toLowerCase() === ".md")
        .map((file) => basename(file, extname(file)));
    } catch (err) {
      console.error(`Error reading how_to directory: ${err}`);
      return [];
    }
  };