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

# MCP overview

> Connect AI assistants to your Zapnito community through its MCP server, with tools to list, search and read your community's content.

Every Zapnito community has its own MCP server. It gives AI assistants access to your community's users, groups, content, discussions, events and more, through a wide range of tools.

> [!NOTE]
>
> To read and manage community data from your own systems, use the [API](https://docs.zapnito.com/api/v1/overview.md). To be notified when something happens in your community, use [webhooks](https://docs.zapnito.com/webhooks/overview.md).

## Why use MCP

The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open standard that lets AI assistants connect to external systems. An MCP server describes the tools it offers, and the assistant decides when to call them to answer a question.

* **Answers come from your community, not guesswork.** Assistants fetch live records instead of relying on what they were trained on.
* **One integration works across assistants.** Any MCP-compatible client can connect to the same server.
* **No custom code.** Your team can ask questions in plain language instead of building API calls.

## What you can do

Ask your assistant questions about your community, and it chooses the right tools to answer them. For example:

* "Which discussions mention onboarding in the last month?"
* "Find the experts in our community who work in data science."
* "What events are coming up, and who is hosting them?"
* "Summarise the documents in our community about carbon capture."

## Connect to your community

Each community has its own MCP server at `/mcp` on the community's domain:

```text title="MCP server URL" theme={null}
https://your-community.zapnito.com/mcp
```

Replace `https://your-community.zapnito.com` with your community's domain.

**1. Open your LLM provider's connection settings**

Open your LLM provider's custom MCP connection (or plugin) settings.

**2. Enter your community's details**

Enter your community's name and the MCP URL.

**3. Sign in**

Sign in when prompted.

Zapnito's MCP server supports Dynamic Client Registration (DCR). Your LLM client registers itself as an OAuth client each time a user connects, so you don't need to create a client ID or paste one in. Most providers detect the connection details from the URL automatically.

Each server is connected to one community. To work with more than one community, add a server for each.

## How the tools work

The server has 28 tools across 11 resources. Most resources have the same three kinds of tool:

| Kind | Use it to | Returns |
| - | - | - |
| `list` | Browse records in a fixed order. | A page of summaries. |
| `search` | Find records by keyword. | A page of summaries, most relevant first. |
| `get` | Read a single record in full. | The full record. |

A typical request uses two steps. The assistant calls `list` or `search` to find the record, then calls `get` with the record's `id` or `slug` to read it in full. Each `list` and `search` tool description names the `get` tool to follow up with.

[Metrics](https://docs.zapnito.com/mcp/capabilities.md#community-health) are the exception. They return aggregate values, such as total members, instead of records, and `list` isn't paginated.

### Pagination

`list` and `search` tools return 25 results per page. Pass `page`, starting at 1, to move through the results. All dates and times are in UTC.

### Search syntax

Most `search` tools support these operators in the `query`:

| Operator | Example | Matches |
| - | - | - |
| Quoted phrase | `"carbon capture"` | The exact phrase. |
| `OR` | `solar OR wind` | Either term. |
| `-` exclusion | `"carbon capture" -offsets` | Results without the excluded word. |

[`zapnito_search_groups`](https://docs.zapnito.com/mcp/capabilities#people-and-expertise) is the exception: it matches any part of a group's name and doesn't support these operators.

## Tools

The server has tools for users, groups, badges, content, discussions, comments, topics, channels, rooms, events and metrics. See [what your assistant can do](https://docs.zapnito.com/mcp/capabilities.md) for example questions and the tools behind them.

> [card] [What your assistant can do](https://docs.zapnito.com/mcp/capabilities.md)
>
> Example questions and the 28 tools behind them.

> [card] [Metrics](https://docs.zapnito.com/mcp/capabilities.md#community-health)
>
> Answer aggregate questions, such as how many members your community has.


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