APS MCP Server

Instructions

Implementation Reference

• src/tools/get-folder-contents.ts:16-29 (handler)

  The async callback handler that performs authentication, initializes the DataManagementClient, fetches folder contents or project top folders, and returns formatted content.

  callback: async ({ accountId, projectId, folderId }) => {
      // TODO: add pagination support
      const accessToken = await getAccessToken(["data:read"]);
      const dataManagementClient = new DataManagementClient();
      const contents = folderId
          ? await dataManagementClient.getFolderContents(projectId, folderId, { accessToken })
          : await dataManagementClient.getProjectTopFolders(accountId, projectId, { accessToken });
      if (!contents.data) {
          throw new Error("No contents found");
      }
      return {
          content: contents.data.map((item) => ({ type: "text", text: JSON.stringify(item) }))
      };
  }

• src/tools/get-folder-contents.ts:6-10 (schema)

  Input schema defining parameters: accountId (required string), projectId (required string), folderId (optional string).

  const schema = {
      accountId: z.string().nonempty(),
      projectId: z.string().nonempty(),
      folderId: z.string().optional()
  };

• src/server.ts:12-14 (registration)

  Generic registration loop that adds all tools exported from src/tools/index.ts to the MCP server, including 'get-folder-contents' via its title.

  for (const tool of Object.values(tools)) {
      server.tool(tool.title, tool.description, tool.schema, tool.callback);
  }

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

  Re-exports the getFolderContents tool from its implementation file for bulk import in server.ts.

  export { getFolderContents } from "./get-folder-contents.js";