> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gorgias MCP server

> Let the Rippit agent read Gorgias tickets, customers, views, tags, and helpdesk reporting.

Connect Gorgias when the agent needs the live helpdesk record: the current state of a ticket a customer is asking about, a customer's recent tickets, or the CSAT comments behind a score.

## What the agent gets

* **Tickets**: list and search tickets, and read one ticket with its messages and internal notes.
* **Customers**: list and read customer profiles.
* **Views and tags**.
* **Reporting**: helpdesk metrics, ticket patterns, and CSAT breakdowns.

Gorgias adds tools over time, so **Tool permissions** on the server's page shows the exact list for your connection.

If Gorgias is already a Rippit integration, your tickets are in Rippit and you do not need this connector to analyze them in bulk (see the [Gorgias data integration](https://docs.rippit.com/plg/data-integrations/gorgias.md)). Connect the MCP server when you want the agent to look up individual tickets or customers as they are right now.

## Setup

In Rippit, open **Connections → MCP Servers**, choose **Gorgias**, and sign in. Gorgias asks for your Gorgias subdomain, then for you to sign in and authorize Rippit. Rippit registers itself automatically, so there is no Gorgias app or API key to set up first. The API key from the Gorgias data integration is not used.

Gorgias's MCP server is available on all Gorgias Helpdesk plans and is in open beta.

## Identity and scope

The connection acts as the Gorgias user who signed in, limited by that user's Gorgias role. Each connection reaches one Gorgias account. Disconnecting in Rippit stops the agent from using it.

## Tools

You choose which tools the agent can use under **Tool permissions** on the server's page, one at a time or a whole group at once. See [Setting one up](https://docs.rippit.com/agentic-chat/overview.md#setting-one-up).

Only the tools Gorgias marks read-only start enabled. Write tools stay off until you turn them on. Some of them send messages to customers, such as `create_message` and `reply_and_close`, and others change rules, macros, views, Help Center articles, or AI Agent settings that go live.

| Tool | What it does |
| - | - |
| `list_tickets`, `search_tickets` | List and search tickets |
| `get_ticket` | Read one ticket with its messages |
| `list_customers`, `get_customer` | List and read customers |
| `list_views`, `get_view` | List and read saved ticket views |
| `list_tags` | List ticket tags |
| `get_reporting_stats`, `csat_investigation`, `ticket_pattern_breakdown` | Helpdesk metrics, CSAT, and ticket patterns |


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