> For the complete documentation index, see [llms.txt](https://docs.keeping.com/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeping.com/help/mcp-server/what-is-the-keeping-mcp-server.md).

# What is the Keeping MCP server?

The Keeping MCP server lets you connect Keeping to AI tools like Claude, ChatGPT, Cursor, and others that support the Model Context Protocol (MCP).

### What is an MCP server?

An MCP (Model Context Protocol) server is a way to give AI assistants like Claude or ChatGPT secure, direct access to the tools and data they need to help you.

Think of it like a universal adapter - instead of copying and pasting information back and forth between your apps and an AI chat window, an MCP server lets the AI read your data and take actions on your behalf, with your permission. It's an open standard, which means it works the same way across different AI tools, so you set it up once and any compatible assistant can use it.

### The Keeping MCP Server

The Keeping MCP server lets you connect your helpdesk to AI tools like Claude, ChatGPT, Cursor, and others that support the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). Once connected, your AI assistant can read and manage your support conversations, check team performance, and, if you're an admin, set up and manage your company's mailboxes, agents, tags, templates, workflows, and SLAs - all using your existing Keeping account and permissions.

{% content-ref url="/pages/XYg0DThf32yCNYxnhQxb" %}
[Connecting to Keeping's MCP server](https://docs.keeping.com/help/mcp-server/connecting-to-keepings-mcp-server.md)
{% endcontent-ref %}

### What Can the MCP Server Do?

The Keeping MCP server provides more than 80 tools, organized into four categories. Which ones your AI assistant sees depends on the permissions you grant when you connect. See [Permissions & Scopes](https://docs.keeping.com/help/mcp-server/connecting-to-keepings-mcp-server.md#permissions-and-scopes).

#### Read Tools

Look up tickets, messages, notes, drafts, activity, mailboxes, agents, tags, templates, ticket counts, SLA violations, and your own preferences.

#### Analytics Tools

Reporting and performance metrics: team, ticket, message, agent, tag, and CSAT reports, plus a personal snapshot of your own performance.

#### Write Tools

Take actions in your shared inbox: draft replies and new tickets, change status, assignment, tags and priority, add notes, move a ticket to another mailbox, set custom fields, share a ticket, and manage your own signature and preferences.

{% hint style="info" %}
Write tools create drafts - they do not send messages directly. Sending always happens from within the Keeping app, in the Keeping Inbox or Gmail, to ensure human review.
{% endhint %}

For the full list of tools, with what each does, the permission it needs, and which ones ask for confirmation, see the [MCP tool reference](https://docs.keeping.com/help/mcp-server/mcp-tool-reference.md).

#### Admin Tools

If you're an admin, you can also let your AI assistant set up and manage your company. These tools are available only to company admins, on plans with Advanced MCP. Reading settings works at every permission level, and changing them needs **Read, Write, and Manage Settings** when connecting. See [Permissions & Scopes](https://docs.keeping.com/help/mcp-server/connecting-to-keepings-mcp-server.md#permissions-and-scopes).

{% hint style="warning" %}
Deleting something, and many changes to existing settings, ask you to confirm first. Your AI assistant should describe the exact change and check with you before it confirms on your behalf.
{% endhint %}

| Area                     | What your AI assistant can do                                                                                                                      |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agents**               | Invite, update, and remove agents, resend invitations, list pending invitations, and approve or deny access requests                               |
| **Mailboxes**            | Create and update mailboxes, set a mailbox auto-reply, resend the verification email, and start a one-time import of up to 28 days of past email   |
| **Tags & custom fields** | Create, update, and delete tags; list, create, and update custom fields                                                                            |
| **Templates**            | Create, update, and delete templates and template labels                                                                                           |
| **Company settings**     | Read and change the company name, whether the ticket ID appears in the subject, and business hours                                                 |
| **Workflows**            | List, create, update, delete, and reorder workflows, and look up the available triggers, conditions, and actions                                   |
| **SLAs**                 | List, create, update, and delete SLAs, and look up the available options                                                                           |
| **CSAT**                 | Read and change CSAT settings and the CSAT survey template                                                                                         |
| **Reports**              | A company support summary for a date range, with the same numbers as the Reports page                                                              |
| **Plan & integrations**  | Read-only views of your plan, trial, and seat usage, and of which integrations are connected. Plan and billing changes still happen on keeping.com |

### Usage Examples

Once connected, you can ask your AI assistant things like:

**Reading data:**

* *"Show me all open tickets in the Support mailbox"*
* *"Find conversations tagged 'billing' from the last week"*
* *"What are my current SLA violations?"*
* *"List all available templates"*

**Taking action:**

* *"Draft a reply to ticket SUP-42 using the 'refund confirmation' template"*
* *"Assign the latest unassigned ticket to Sarah"*
* *"Tag conversation SUP-108 as 'urgent' and set priority to high"*
* *"Add an internal note to SUP-55: 'Customer called — prefers phone follow-up'"*
* *"Set the order number on SUP-42 to 10492"*

**Setting up your company (admins):**

* *"Invite <jordan@example.com> as an agent and give them access to the Support mailbox"*
* *"Create a tag called 'refund request' and a workflow that assigns tickets with that tag to Sarah"*
* *"Set our business hours to 9 to 5, Monday to Friday"*

**Analytics:**

* *"How many tickets did the team close this week?"*
* *"Show me response time trends for the last 30 days"*
* *"What's our CSAT score this month?"*

{% content-ref url="/pages/XYg0DThf32yCNYxnhQxb" %}
[Connecting to Keeping's MCP server](https://docs.keeping.com/help/mcp-server/connecting-to-keepings-mcp-server.md)
{% endcontent-ref %}

### Privacy & Terms

Your data is handled according to Keeping's existing privacy and security practices. The MCP server:

* Only accesses data your account already has permission to view
* Does not store conversation content beyond what's needed to fulfill requests
* Logs tool usage for audit and security purposes
* Respects all existing team permissions and mailbox access controls

For full details, see our [Privacy Policy](https://keeping.com/privacy-policy) and [Terms of Service](https://keeping.com/terms-of-service).
