subthread_get_all

Retrieve all subthreads for a team using pagination and filters to organize and manage thread data efficiently on Buu AI MCP Server.

Instructions

[PRIVATE] Get all team's subthreads.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`filters`	No	Filter criteria to narrow down thread results
`pagination`	No	Pagination settings for querying threads

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
      }
    }
  }
`;

Buu AI MCP Server