# What is the Keeping MCP server? ### 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, look up customers, check team performance, and more - all using your existing Keeping account and permissions. {% content-ref url="connecting-to-keepings-mcp-server" %} [connecting-to-keepings-mcp-server](https://docs.keeping.com/help/mcp-server/connecting-to-keepings-mcp-server) {% endcontent-ref %} ### What Can the MCP Server Do? The Keeping MCP server provides **33 tools** organized into three categories: #### Read Tools These tools let your AI assistant retrieve information from your shared inbox: | Tool | Description | | ----------------------------- | ------------------------------------------------ | | **Get Me** | Returns your identity and accessible resources | | **Search Conversations** | Search conversations using structured queries | | **Get Conversation** | Retrieve a single conversation with full details | | **List Conversations** | List conversations with filtering and pagination | | **Get Conversation Messages** | Get messages for a conversation with previews | | **Get Notes** | Get internal notes for a conversation | | **Get Draft Messages** | Get draft messages for a conversation | | **List Mailboxes** | List all mailboxes you can access | | **List Agents** | List team members | | **List Tags** | List all available tags | | **List Templates** | List canned response templates | | **Get Current Counters** | Get ticket counts by status | | **Get SLA Violations** | Get conversations that have breached SLA | | **Get Activity** | Get the activity log for a conversation | #### Analytics Tools These tools provide reporting and performance metrics. | Tool | Description | | ------------------------------- | ----------------------------------------------- | | **Get Team Report** | Team performance overview for a date range | | **Get Ticket Report** | Ticket volume over time (daily new/closed/open) | | **Get Message Report** | Message volume over time (daily sent/received) | | **Get My Highlights** | Quick personal performance snapshot | | **Get Agent Report** | Individual agent performance over time | | **Get Tag Report** | Tag performance metrics | | **Get Tag Intersection Report** | Stats for conversations matching multiple tags | | **Get CSAT Report** | Customer satisfaction scores and ratings | #### Write Tools These tools let your AI assistant take actions in your shared inbox. {% hint style="info" %} Currently, you can only create **draft** conversations from the MCP server. You can send them from Gmail or the Keeping Web App. {% endhint %} | Tool | Description | | ------------------------ | ---------------------------------------------- | | **Create Draft Message** | Draft a reply on a conversation | | **Edit Draft Message** | Update an existing draft | | **Delete Draft Message** | Remove a draft | | **Create Conversation** | Create a new draft ticket | | **Change Status** | Set a conversation to open, pending, or closed | | **Change Assignments** | Assign or unassign agents | | **Change Tags** | Add or remove tags | | **Change Priority** | Set priority to low, medium, or high | | **Add Note** | Add an internal note to a conversation | | **Move Conversation** | Move a conversation to a different mailbox | | **Generate Share Link** | Create a public share link for a conversation | {% hint style="info" %} Write tools create drafts - they do not send messages directly. Sending always happens from within the Keeping app to ensure human review. {% endhint %} ### 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'"* **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="connecting-to-keepings-mcp-server" %} [connecting-to-keepings-mcp-server](https://docs.keeping.com/help/mcp-server/connecting-to-keepings-mcp-server) {% 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).