Buu AI MCP Server

Instructions

Implementation Reference

• src/tools/SubthreadTools.ts:137-149 (handler)

  The async handler function for the 'subthread_get' tool. It takes a subthreadId, queries the GraphQL client using getSubthreadQuery, and returns the response or an error.

    async ({ subthreadId }) => {
      try {
        const response = await client.request(getSubthreadQuery, { subthreadId });
        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
      } catch (error) {
        console.error('Error calling subthread_get:', error);
        return {
          isError: true,
          content: [{ type: 'text', text: `Error: Failed to retrieve subthread. ${error}` }],
        };
      }
    }
  );

• src/tools/SubthreadTools.ts:134-136 (schema)

  Input schema validation for the subthread_get tool using Zod: requires a subthreadId string.

  {
    subthreadId: z.string().describe('ID of the subthread to fetch'),
  },

• src/tools/SubthreadTools.ts:131-150 (registration)

  Registration of the 'subthread_get' tool using server.tool(), including description, input schema, and inline handler function.

  server.tool(
    'subthread_get',
    "[PRIVATE] Get team's subthread by ID.",
    {
      subthreadId: z.string().describe('ID of the subthread to fetch'),
    },
    async ({ subthreadId }) => {
      try {
        const response = await client.request(getSubthreadQuery, { subthreadId });
        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
      } catch (error) {
        console.error('Error calling subthread_get:', error);
        return {
          isError: true,
          content: [{ type: 'text', text: `Error: Failed to retrieve subthread. ${error}` }],
        };
      }
    }
  );

• src/tools/SubthreadTools.ts:28-49 (helper)

  GraphQL query 'getSubthreadQuery' definition used by the subthread_get handler to fetch the subthread details by ID.

  const getSubthreadQuery = gql`
    query Subthread($subthreadId: String!) {
      getSubthread(subthreadId: $subthreadId) {
        ... on Subthread {
          _id
          createdAt
          updatedAt
          teamId
          threadId
          prompt
          style
          imageUrl
          strength
          address
        }
        ... on HandledError {
          code
          message
        }
      }
    }
  `;

• src/index.ts:48-48 (registration)

  Call to registerSubthreadTools on the main MCP server instance, which registers the subthread_get tool among others.

  registerSubthreadTools(server, buuServerClient);