> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapnito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Group tools

> Tools for finding groups in your Zapnito community and reading the full detail of a single group.

Use these tools to find the groups in your community and read them in full. For every tool at a glance, see [All MCP tools](https://docs.zapnito.com/mcp/tools/all.md). For how the tools work together, see the [MCP overview](https://docs.zapnito.com/mcp/overview.md#how-the-tools-work).

Every `list` and `search` tool accepts an optional `page`, an integer starting at 1, with 25 results per page.

Each group has a `group_type` of `Person` or `Organisation`. Every group tool returns this field.

## List groups

`zapnito_list_groups`

Lists groups by name (A-Z), 25 per page. Returns summaries only. To read a group in full, call [Get a group](#get-a-group).

Example prompt: "List the groups in our community."

## Search groups

`zapnito_search_groups`

Finds groups whose name contains the text you give, ignoring case, A-Z. Returns summaries only.

> [!NOTE]
>
> Unlike the other search tools, this tool doesn't support phrases, `OR` or `-` exclusion.

**query** `string` *required*

The text to find in group names, such as `marketing`.

```json title="Arguments" theme={null}
{
  "query": "marketing"
}
```

Example prompt: "Find the groups with marketing in their name."

## Get a group

`zapnito_get_group`

Returns the full detail of one group, including its `group_type`.

**id** `integer | string` *required*

The ID or slug of the group.

```json title="Arguments" theme={null}
{
  "id": "marketing-team"
}
```

Example prompt: "Show me the details of the marketing-team group."


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.