Buu AI MCP Server

Instructions

Implementation Reference

• src/tools/SubthreadTools.ts:158-169 (handler)

  The async handler function for the 'subthread_get_all' tool. It sends a GraphQL query to fetch subthreads using the provided pagination and filters, returns the JSON response, or an error message if the request fails.

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

• src/tools/SubthreadTools.ts:154-157 (schema)

  Zod input schema defining optional 'pagination' and 'filters' parameters for the tool.

  {
    pagination: z.any().optional().describe('Pagination settings for querying threads'),
    filters: z.any().optional().describe('Filter criteria to narrow down thread results'),
  },

• src/tools/SubthreadTools.ts:151-170 (registration)

  Direct registration of the 'subthread_get_all' tool via server.tool() call within registerSubthreadTools function.

  server.tool(
    'subthread_get_all',
    "[PRIVATE] Get all team's subthreads.",
    {
      pagination: z.any().optional().describe('Pagination settings for querying threads'),
      filters: z.any().optional().describe('Filter criteria to narrow down thread results'),
    },
    async ({ pagination, filters }) => {
      try {
        const response = await client.request(getSubthreadsQuery, { pagination, filters });
        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
      } catch (error) {
        console.error('Error calling subthread_get_all:', error);
        return {
          isError: true,
          content: [{ type: 'text', text: `Error: Failed to retrieve subthreads. ${error}` }],
        };
      }
    }
  );

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

  Invocation of registerSubthreadTools in the main server setup, which registers the subthread_get_all tool among others.

  registerSubthreadTools(server, buuServerClient);

• src/tools/SubthreadTools.ts:51-84 (helper)

  GraphQL query definition 'getSubthreadsQuery' used by the subthread_get_all handler to fetch subthreads.

  const getSubthreadsQuery = gql`
    query GetSubthreads($pagination: Pagination, $filters: SubthreadFilter) {
      getSubthreads(pagination: $pagination, filters: $filters) {
        ... on SubthreadsPage {
          items {
            _id
            createdAt
            updatedAt
            teamId
            threadId
            prompt
            style
            imageUrl
            strength
            address
          }
          metadata {
            limit
            offset
            orderBy
            orderDirection
            numElements
            total
            page
            pages
          }
        }
        ... on HandledError {
          code
          message
        }
      }
    }
  `;