> ## 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.

# All MCP tools

> A complete list of the 28 tools on your Zapnito community's MCP server, with what each one does and when to use it.

Your community's MCP server has 28 tools across 11 resources.

Most resources follow the same pattern. Your assistant uses `list` or `search` to find records, then `get` to read one in full. `list` and `search` return summaries only. For the arguments and an example prompt for each tool, see the page for each resource, such as [Users](https://docs.zapnito.com/mcp/tools/users.md) or [Metrics](https://docs.zapnito.com/mcp/tools/metrics.md). For example questions, see [what your assistant can do](https://docs.zapnito.com/mcp/capabilities.md). For pagination and search syntax, see the [MCP overview](https://docs.zapnito.com/mcp/overview.md#how-the-tools-work).

## Users

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_users` | Lists users by name (A-Z), as summaries. | Browse your member directory. |
| `zapnito_search_users` | Searches users by name, title, company or profile text, most relevant first. | Find experts and colleagues by role, company or what's in their profile. |
| `zapnito_get_user` | Returns the full detail of one user, found by ID, slug or email address. | Look up a specific person's profile. |

## Groups

Each group is either a `Person` or an `Organisation` group, and the tools return this as `group_type`.

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_groups` | Lists groups by name (A-Z), as summaries. | Browse all your groups and see which are for people and which are for organisations. |
| `zapnito_search_groups` | Finds groups whose name contains the text you give, ignoring case. | Find a group when you know part of its name. |
| `zapnito_get_group` | Returns the full detail of one group, found by ID or slug. | Read a group's detail, including its type. |

## Badges

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_badges` | Lists badges, as summaries. | See which badges your community has. |
| `zapnito_get_badge` | Returns the full detail of one badge, found by ID or slug. | Read what a specific badge is. |

## Content

Content is a post, a video or a document. Each summary includes the content's type.

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_contents` | Lists content, newest first. Can be limited to posts, videos or documents. | See what's been published recently, or browse only documents or videos. |
| `zapnito_search_contents` | Searches content by keyword, most relevant first. Can be limited to posts, videos or documents. | Find what your community knows about a subject. |
| `zapnito_get_content` | Returns the full detail of one post, video or document, found by ID or slug. | Read a piece of content in full, for example to summarise it. |

## Discussions

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_discussions` | Lists discussions, newest first, as summaries. | See the latest conversations. |
| `zapnito_search_discussions` | Searches discussions by keyword, most relevant first. | Find conversations about a subject, such as onboarding. |
| `zapnito_get_discussion` | Returns the full detail of one discussion, found by ID or slug. | Read a discussion in full. |

## Comments

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_comments` | Lists comments, newest first, as summaries. | Keep an eye on the latest comments. |
| `zapnito_get_comment` | Returns the full detail of one comment, found by its numeric ID. Slugs aren't supported. | Read a specific comment in full. |

## Topics

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_topics` | Lists topics, newest first, as summaries. | See which topics your community covers and what's new. |
| `zapnito_get_topic` | Returns the full detail of one topic, found by ID or slug. | Read a topic's detail. |

## Channels

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_channels` | Lists channels, newest first, as summaries. | See which channels exist and which are newest. |
| `zapnito_get_channel` | Returns the full detail of one channel, found by ID or slug. | Read a channel's detail. |

## Rooms

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_rooms` | Lists rooms, newest first, as summaries. | See which rooms exist and which are newest. |
| `zapnito_search_rooms` | Searches rooms by keyword, most relevant first. | Find a room about a subject, such as customer success. |
| `zapnito_get_room` | Returns the full detail of one room, found by ID or slug. | Read a room's detail. |

## Events

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_events` | Lists events, most recently starting first, as summaries. | Browse your events. |
| `zapnito_search_events` | Searches events by keyword, most relevant first. | Find events about a subject, such as a product launch or annual summit. |
| `zapnito_get_event` | Returns the full detail of one event, found by ID or slug. | Read an event's detail. |

## Metrics

Metrics are aggregate numbers about your community. They have no `search` tool.

| Tool | What it does | Use it to |
| - | - | - |
| `zapnito_list_metrics` | Lists the available metrics with a description, category, unit and the time ranges each one supports. Can be limited to members, content, discussions or comments. | Check which numbers you can ask for, and how far back each goes. |
| `zapnito_get_metric` | Returns the value of one metric, for a ready-made period or your own start and end dates. | Get a single number, such as total members or new members last month. |


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