# Gorgias MCP for AI Agents AI Agent Connect > Gorgias MCP lets you manage your e-commerce helpdesk directly through your AI client. You can pull up ticket histories, draft replies to customers, and update user profiles without leaving your workspace. It turns your agent into a support rep that knows your customer base inside and out. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JPVJotKoI5n5165fUFKyP5MxvEjP5JkqxrhYqQo0/ai-agent-connect - **Tags:** ticket-management, customer-service, conversation-history, helpdesk, ecommerce-support ## Description Imagine you're buried in a mountain of support tickets. Usually, you'd have to flip back and forth between your chat window and the Gorgias dashboard just to see a customer's history or find out what they bought last month. This Connector changes that. You can just ask your AI to find a specific customer's profile or summarize a long, messy conversation thread. It handles the heavy lifting of looking up data so you can focus on actually helping the person on the other end. Whether you're drafting a polite response to a shipping delay or just need to see which agents are currently active, everything happens in one place. It’s a huge time saver for anyone who spends their day in a support queue. By connecting this to the Vinkius catalog, you get a dedicated way to handle your helpdesk operations without the constant tab-switching. You get to move faster because your agent is actually looking at the real-time data from your Gorgias account. ## Tools ### create_ticket Open a new support request in the system. This helps you track new issues as they come in. ### update_ticket Change the status or details of an active ticket. This is how you move tickets through your workflow. ### create_customer Create a new profile for a shopper. This keeps your database current as you talk to new people. ### create_message Add a reply or a private internal note to a ticket. Use this to communicate with customers or your team. ### get_customer Pull up the specific details for a single customer. It's the fastest way to see a user's history. ### get_ticket View the full details of a specific support request. Use this to understand the context of a problem. ### get_user See the details for a specific team member. This is useful for checking agent permissions or info. ### list_customers Search through your entire customer base. You can find anyone by their email or other details. ### list_messages View the full chat history within a single ticket. This helps your agent see the full story. ### list_tickets Pull up a list of all your current support tickets. Use this to see what's waiting in the queue. ### list_users See all agents currently in your workspace. This helps with team coordination and monitoring. ### update_customer Modify an existing customer profile. Use this to keep contact info or tags accurate. ## Prompt Examples **Prompt:** ``` Show me the 5 most recent open tickets. ``` **Response:** ``` Fetching tickets... You have 5 recent open tickets: | Ticket ID | Customer | Subject | | :--- | :--- | :--- | | #1042 | john@example.com | Where is my order? | | #1041 | sarah@example.com | Refund request | | #1040 | mike@example.com | Size exchange | | #1039 | lara@example.com | Shipping delay | | #1038 | tom@example.com | Damaged item | Would you like me to read the messages for Ticket #1042? ``` **Prompt:** ``` Reply to ticket #1042 saying their order has been shipped and provide the tracking link. ``` **Response:** ``` Drafting reply... I've successfully posted a message to Ticket #1042 informing John that his order is on the way with the tracking details. Should I close the ticket? ``` **Prompt:** ``` Check if there's a profile for alex.smith@example.com. ``` **Response:** ``` Checking customer records... Yes, I found a matching profile. **Customer ID:** 90210 **Name:** Alex Smith **Status:** Active **Recent Activity:** * 2 resolved past tickets * 0 active issues ``` ## Capabilities ### Fetch open tickets View your current queue to see what needs attention. ### Summarize conversations Get a quick recap of long ticket threads. ### Draft customer replies Generate responses based on specific ticket history. ### Search customer profiles Find specific users by their email or details. ### Manage agent status See which team members are currently online. ## Use Cases ### Summarizing a long thread A customer is angry about a late order. The agent uses list_messages to see the history and asks the AI to summarize the main issue. ### Pre-call research A manager wants to call a VIP. They use list_customers to find the account and see every past ticket. ### Quick ticket updates An agent finishes a task and uses update_ticket to change the status to resolved. ### Internal notes A teammate needs a hand. The agent uses create_message to add an internal note for the next person. ## Benefits - Stop tab-switching by pulling customer data directly into your chat. Use get_customer to see history instantly. - Write faster replies with create_message to draft responses based on previous interactions. - Get a clear view of your team with list_users to see who's active. - Keep your records clean by using update_customer to fix info on the fly. - Handle high-volume queues by using list_tickets to see what's waiting in the queue. ## How It Works The bottom line is you get a direct line from your AI to your helpdesk data. 1. Subscribe to the Gorgias MCP on Vinkius. 2. Provide your Gorgias subdomain, email, and REST API key. 3. Start asking your AI client to draft replies or list tickets. ## Frequently Asked Questions **Can the Gorgias MCP help my team reply to customers faster?** Yes. It lets your AI draft professional replies based on your actual ticket history, so you don't have to type everything from scratch. **Does the Gorgias MCP work with my existing helpdesk?** Yes, it connects directly to your existing Gorgias account to pull in real-time data. **Can I use the Gorgias MCP to see my customer history?** Yes. Your agent can look up specific customer profiles to see their purchase history and past interactions instantly. **How does the Gorgias MCP handle my internal notes?** It allows your AI to add internal notes to tickets, making it easy to leave instructions for other team members. **Can I see which agents are active with the Gorgias MCP?** Yes. You can ask your AI to list all agents in your workspace to see who is currently online. **Does the Gorgias MCP support updating customer info?** Yes. You can tell your agent to update a customer's profile information, and it will sync those changes back to Gorgias. **Can I add an internal note to a ticket instead of replying to the customer?** Yes! When using the `create_message` tool, you can specify the channel as 'internal-note'. This allows the AI agent to leave insights or summaries for other human agents to read. **How do I find a customer's recent tickets?** First, use `list_customers` with their email address to find their Customer ID. Then, you can use `list_tickets` or ask the AI to summarize their interaction history. **Can the AI resolve tickets for me?** Yes. The agent can use the `update_ticket` tool to change the status of a ticket to 'closed' once an issue is verified as resolved.