# Kustomer MCP > Kustomer gives your AI client deep access into customer support data. It lets you list full customer records, audit conversations across email, chat, and social media, and search complex historical timelines. You can pull up a person's entire service history—everything from the initial ticket to every follow-up message. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** omnichannel-support, customer-360, support-automation, conversation-history, crm-integration ## Description When you connect your agent to Kustomer, you gain immediate access to a client’s complete support file. Forget jumping between email systems, chat logs, and social platforms just to understand what happened last week. This MCP pulls it all together into one view. Your AI can pull up a customer's full profile, grabbing everything from their custom attributes to their lifetime interaction history. You can list recent conversations across every channel—be it email or live chat—and drill down into the message details for any specific support exchange. Need to know what happened three months ago? You can perform deep searches across the entire customer timeline using complex filters. It’s all about context. The agent doesn't just read data; it understands the complete service history, which is crucial for auditing compliance or simply getting up to speed on a high-value client. Because Vinkius hosts this MCP, your AI can call Kustomer alongside other services in one go, giving you a single pane of glass view of customer interactions. ## Tools ### list_kustomer_customers Gets a list of all customer IDs, which is necessary for starting any audit or lookup. ### get_customer_profile Pulls the full details and attributes for one specific client ID. ### list_support_conversations Retrieves a list of recent support interactions across all channels. ### get_conversation_details Fetches the general information and status for one specific conversation ticket. ### list_conversation_messages Lists every message sent within a particular support conversation, chronologically. ### list_support_queues Provides the names and details of active support queues (like Billing or Technical Support). ### list_kustomer_agents Lists all user accounts who work as agents within Kustomer. ### search_kustomer_timeline Performs a deep search across the customer's entire history using complex filter criteria. ### list_data_klasses Lists custom data types (Klasses) that are used to store specific, non-standard information about customers. ### check_kustomer_api_status Verifies if the Kustomer API connection is currently operational and working correctly. ## Prompt Examples **Prompt:** ``` List the 10 most recent support conversations in Kustomer ``` **Response:** ``` I've retrieved the latest 10 conversations. 4 are currently 'Open' and assigned to agents, while 6 are 'Done'. Would you like to audit the messages for the open ones? ``` **Prompt:** ``` Show the full profile for customer '65a4b3c2d1e0f' ``` **Response:** ``` Retrieved profile for Jane Doe. She is a 'Platinum' member with a lifetime value of $1,200. Her last contact was via Email 2 days ago regarding a shipping delay. ``` **Prompt:** ``` Search the timeline for customers from 'Brazil' ``` **Response:** ``` Searching timeline… I found 15 customers associated with 'Brazil'. 10 have active conversations. Would you like a list of their email addresses? ``` ## Capabilities ### Retrieve Customer Profiles Pull up a client's complete record, including custom details and full history. ### Audit Support Interactions List and review all support conversations from email, chat, or social channels. ### Deep Timeline Search Run complex searches across a customer’s entire interaction history using detailed filters. ### Review Message History Get the full, sequential message log for any specific conversation or ticket. ### Identify Support Resources List active support queues and available agents within Kustomer. ## Use Cases ### A high-value client complains about inconsistent service. The CX Manager needs to know exactly why a Platinum member is upset. They ask their agent, 'Show me all interactions for customer X.' The agent uses `get_customer_profile` and `search_kustomer_timeline`, delivering a full timeline that reveals the billing error from two months ago and the chat support failure last week. ### Investigating a potential data breach or miscommunication. A compliance team needs to audit all communication related to sensitive data. They ask their agent to `list_conversation_messages` for specific dates, immediately retrieving the full message logs from every channel, making auditing fast and precise. ### Onboarding a new support agent. A manager needs to teach a new team member about internal processes. They ask their agent to `list_support_queues` and `list_kustomer_agents`, getting an immediate rundown of available departments, who's on the payroll, and where tickets belong. ### Checking if a client was previously flagged for issues. Before making a sales call, you need to know the full context. You ask your agent to `list_kustomer_customers` to find the ID, then run `search_kustomer_timeline` with filters like 'negative sentiment' or 'escalation' to surface any past problems. ## Benefits - Stop relying on fragmented data. By using the `get_customer_profile` tool, your agent pulls all client attributes and history into one spot, giving you a true 360-degree view without switching tabs. - Compliance checks become simple. Instead of manually gathering records, use the `list_conversation_messages` tool to pull every message sent during a specific support interaction for immediate auditing. - Improve triage speed. The agent can check all defined support queues using `list_support_queues`, allowing you to instantly know where an issue needs to be routed before submitting a ticket. - Deep investigation is easy. Use the powerful `search_kustomer_timeline` tool, which lets you apply complex filters across years of data to find that one critical interaction. - Never lose context again. The ability to list recent support conversations means your agent always knows what's open and who it's assigned to via `list_support_conversations`. ## How It Works The bottom line is that your AI can use Kustomer’s native functions via natural language prompts without needing direct access credentials or manual API calls. 1. Subscribe to this MCP and generate a Bearer API Key from your Kustomer account settings. 2. Provide the key in the Vinkius configuration panel so your agent can authenticate with the service. 3. Tell your AI client what you need—for example, 'Show me all open conversations for customer XYZ.' The agent uses the tools to pull and summarize the data. ## Frequently Asked Questions **How do I list all customers using Kustomer MCP?** You use the `list_kustomer_customers` tool. This provides a comprehensive list of every unique ID in your account, which you need before pulling any detailed profiles or running audits. **Can I only get messages for one conversation with Kustomer MCP?** No, you can retrieve specific conversations using `list_support_conversations`, and then pull the full log of every message within that chat history by calling `list_conversation_messages`. **What is the best way to audit a customer's data with Kustomer MCP?** The most complete method involves three steps: first, use `get_customer_profile` for attributes; second, run `search_kustomer_timeline` for historical events; and third, review specific messages using `list_conversation_messages`. **Does Kustomer MCP help me find out what queues are active?** Yes. Use the `list_support_queues` tool to get a complete list of all active support categories, like Billing or Technical Support, ensuring you route tickets correctly. **Is Kustomer MCP better than just using the native Kustomer UI?** It's faster and more flexible. Instead of navigating menus in the UI, your agent performs complex data retrieval—like deep timeline searches—in seconds via natural language prompts.