# Gorgias — how to use (mcp.ai)

Gorgias is a helpdesk and live chat platform specializing in e-commerce, offering automated support, order management, and unified customer communication

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gorgias?ms=1781542620000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gorgias_add_ticket_tags`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gorgias`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gorgias/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gorgias/add/ticket/tags` — Adds tags to a ticket in gorgias.
  - body: { tag_ids: integer[], ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/create/account/setting` — Creates a new account setting in gorgias.
  - body: { name: string, value: string, description?: string }
- `POST https://api.mcp.ai/api/gorgias/create/customer` — Creates a new customer in gorgias.
  - body: { data?: object, name: string, email?: string, address?: object, channels?: object[], external_id?: string }
- `POST https://api.mcp.ai/api/gorgias/create/team` — Creates a new team in gorgias.
  - body: { name: string, members?: integer[], decoration?: object, description?: string }
- `POST https://api.mcp.ai/api/gorgias/create/ticket` — Creates a new ticket in gorgias.
  - body: { via?: string, meta?: object, tags?: integer[], status?: string, channel?: string, subject?: string, language?: string, messages?: object[], priority?: string, customer_id: integer, external_id?: string, assignee_team_id?: integer, assignee_user_id?: integer }
- `POST https://api.mcp.ai/api/gorgias/delete/customer` — Deletes a specific customer from gorgias.
  - body: { customer_id: integer }
- `POST https://api.mcp.ai/api/gorgias/delete/customer/field/value` — Deletes a specific field value for a customer in gorgias.
  - body: { field_id: integer, customer_id: integer }
- `POST https://api.mcp.ai/api/gorgias/delete/customers` — Deletes multiple customers from gorgias.
  - body: { customer_ids: integer[] }
- `POST https://api.mcp.ai/api/gorgias/delete/team` — Deletes a specific team from gorgias.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/gorgias/delete/ticket` — Deletes a specific ticket from gorgias.
  - body: { ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/delete/ticket/field/value` — Deletes a specific field value for a ticket in gorgias.
  - body: { field_id: integer, ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/get/account` — Retrieves your gorgias account information.
- `POST https://api.mcp.ai/api/gorgias/get/customer` — Retrieves a specific customer from gorgias.
  - body: { customer_id: integer }
- `POST https://api.mcp.ai/api/gorgias/get/event` — Retrieves a specific event from gorgias.
  - body: { event_id: integer }
- `POST https://api.mcp.ai/api/gorgias/get/team` — Retrieves a specific team from gorgias.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/gorgias/get/ticket` — Retrieves a specific ticket from gorgias.
  - body: { ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/list/account/settings` — Lists all account settings in gorgias.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/gorgias/list/customer/field/values` — Lists all field values for a customer in gorgias.
  - body: { customer_id: integer }
- `POST https://api.mcp.ai/api/gorgias/list/customers` — Lists customers in gorgias with various filtering options.
  - body: { name?: string, email?: string, limit?: integer, offset?: integer, order_by?: string, order_dir?: string, created_to?: string, external_id?: string, created_from?: string }
- `POST https://api.mcp.ai/api/gorgias/list/events` — Lists events in gorgias with various filtering options.
  - body: { type?: string, limit?: integer, offset?: integer, context?: string, user_id?: integer, object_id?: integer, created_to?: string, object_type?: string, created_from?: string }
- `POST https://api.mcp.ai/api/gorgias/list/teams` — Lists teams in gorgias.
- `POST https://api.mcp.ai/api/gorgias/list/ticket/field/values` — Lists all field values for a ticket in gorgias.
  - body: { ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/list/ticket/tags` — Lists all tags for a ticket in gorgias.
  - body: { ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/list/tickets` — Lists tickets in gorgias with various filtering options.
  - body: { limit?: integer, offset?: integer, status?: string, tag_id?: integer, channel?: string, language?: string, order_by?: string, priority?: string, order_dir?: string, created_to?: string, updated_to?: string, customer_id?: integer, external_id?: string, created_from?: string, updated_from?: string, assignee_team_id?: integer, assignee_user_id?: integer }
- `POST https://api.mcp.ai/api/gorgias/merge/customers` — Merges two customers in gorgias, combining their data and history.
  - body: { source_customer_id: integer, target_customer_id: integer }
- `POST https://api.mcp.ai/api/gorgias/remove/ticket/tags` — Removes tags from a ticket in gorgias.
  - body: { tag_ids: integer[], ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/set/customer/data` — Sets the complete data object for a customer in gorgias.
  - body: { data: object, customer_id: integer }
- `POST https://api.mcp.ai/api/gorgias/set/ticket/tags` — Sets the complete list of tags for a ticket in gorgias.
  - body: { tag_ids: integer[], ticket_id: integer }
- `POST https://api.mcp.ai/api/gorgias/update/account/setting` — Updates an existing account setting in gorgias.
  - body: { value: string, setting_id: integer, description?: string }
- `POST https://api.mcp.ai/api/gorgias/update/customer` — Updates an existing customer in gorgias.
  - body: { data?: object, name?: string, email?: string, address?: object, channels?: object[], customer_id: integer, external_id?: string }
- `POST https://api.mcp.ai/api/gorgias/update/team` — Updates an existing team in gorgias.
  - body: { name?: string, members?: integer[], team_id: integer, decoration?: object, description?: string }
- `POST https://api.mcp.ai/api/gorgias/update/ticket` — Updates an existing ticket in gorgias.
  - body: { meta?: object, status?: string, subject?: string, language?: string, priority?: string, ticket_id: integer, customer_id?: integer, external_id?: string, assignee_team_id?: integer, assignee_user_id?: integer }

## More
- Page: https://mcp.ai/gorgias
- Agent spec (llms.txt): https://mcp.ai/gorgias/llms.txt
- Postman collection: https://mcp.ai/gorgias/postman.json