Gorgias

Gorgias MCP Server for Cloudflare Workers

Available Tools

72 tools available in the Gorgias MCP server. Each tool can be called by AI assistants to perform specific actions.

gorgias_get_rule

Get a single rule by ID.

Args:

id: The rule ID
format: Response format ('json' or 'markdown')

Returns: The rule record with all available fields including code/codeAst.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Rule ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_list_views

List all ticket views from Gorgias.

Views are saved ticket filters that help organize and categorize tickets.

Returns: JSON format: Array of views Markdown format: Formatted table of views

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_view

Get a single view by ID.

Args:

id: The view ID
format: Response format ('json' or 'markdown')

Returns: The view record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "View ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_get_custom_field

Get a single custom field by ID.

Args:

id: The custom field ID
format: Response format ('json' or 'markdown')

Returns: The custom field record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Custom field ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_list_custom_fields

List all custom fields from Gorgias.

Custom fields allow you to store additional structured data on tickets and customers.

Args:

objectType: Filter by object type ('ticket' or 'customer')
format: Response format ('json' or 'markdown')

Returns: JSON format: Array of custom fields Markdown format: Formatted table of custom fields

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "objectType": {
      "enum": [
        "ticket",
        "customer"
      ],
      "type": "string",
      "description": "Filter by object type"
    }
  }
}

gorgias_list_customers

List customers from Gorgias with pagination and filtering.

Returns a paginated list of customers. Use the cursor from the response to fetch the next page.

Args:

limit: Number of customers to return (1-100, default: 20)
cursor: Pagination cursor from previous response
email: Filter by email address
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Customer[], nextCursor } Markdown format: Formatted table of customers

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Filter by email address"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of customers to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_account

Get account information for the Gorgias helpdesk.

Returns: The account record including domain, status, and settings.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_statistics

Get statistics for the Gorgias helpdesk.

Args:

statisticType: Type of statistics to retrieve (required)
startDatetime: Start date for statistics (ISO datetime, required)
endDatetime: End date for statistics (ISO datetime, required)
timezone: Timezone for the statistics (optional)
format: Response format ('json' or 'markdown')

Returns: Statistics data for the specified time range.

{
  "type": "object",
  "required": [
    "statisticType",
    "startDatetime",
    "endDatetime"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone"
    },
    "endDatetime": {
      "type": "string",
      "description": "End datetime (ISO format)"
    },
    "startDatetime": {
      "type": "string",
      "description": "Start datetime (ISO format)"
    },
    "statisticType": {
      "type": "string",
      "description": "Type of statistics"
    }
  }
}

gorgias_test_connection

Test the connection to the Gorgias API.

Returns: Connection status and account information.

{
  "type": "object",
  "properties": {}
}

gorgias_create_custom_field

Create a new custom field in Gorgias.

Args:

objectType: Object type ('ticket' or 'customer') (required)
label: Field label (required)
description: Field description
priority: Display priority
required: Whether the field is required
definitionType: Field type (e.g., 'text', 'number', 'dropdown')
definitionChoices: Array of choices for dropdown fields

Returns: The created custom field record.

{
  "type": "object",
  "required": [
    "objectType",
    "label"
  ],
  "properties": {
    "label": {
      "type": "string",
      "description": "Field label"
    },
    "priority": {
      "type": "integer",
      "description": "Display priority"
    },
    "required": {
      "type": "boolean",
      "description": "Whether field is required"
    },
    "objectType": {
      "enum": [
        "ticket",
        "customer"
      ],
      "type": "string",
      "description": "Object type"
    },
    "description": {
      "type": "string",
      "description": "Field description"
    },
    "definitionType": {
      "type": "string",
      "description": "Field type (text, number, dropdown, etc.)"
    }
  }
}

gorgias_update_custom_field

Update an existing custom field.

Args:

id: Custom field ID to update
label: New field label
description: New field description
priority: New display priority
required: New required setting

Returns: The updated custom field record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Custom field ID to update"
    },
    "label": {
      "type": "string",
      "description": "Field label"
    },
    "priority": {
      "type": "integer",
      "description": "Display priority"
    },
    "required": {
      "type": "boolean",
      "description": "Whether field is required"
    },
    "description": {
      "type": "string",
      "description": "Field description"
    }
  }
}

gorgias_get_customer

Get a single customer by ID.

Args:

id: The customer ID
format: Response format ('json' or 'markdown')

Returns: The customer record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Customer ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_customer

Create a new customer in Gorgias.

Args:

email: Customer email address
name: Full name
firstname: First name
lastname: Last name
externalId: External ID from your system
note: Notes about the customer
language: Preferred language code
timezone: Customer timezone

Returns: The created customer record.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full name"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "lastname": {
      "type": "string",
      "description": "Last name"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone"
    },
    "firstname": {
      "type": "string",
      "description": "First name"
    },
    "externalId": {
      "type": "string",
      "description": "External ID"
    }
  }
}

gorgias_update_customer

Update an existing customer.

Args:

id: Customer ID to update
email: New email address
name: New full name
firstname: New first name
lastname: New last name
externalId: New external ID
note: New notes
language: New language code
timezone: New timezone

Returns: The updated customer record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Customer ID to update"
    },
    "name": {
      "type": "string",
      "description": "Full name"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "lastname": {
      "type": "string",
      "description": "Last name"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone"
    },
    "firstname": {
      "type": "string",
      "description": "First name"
    },
    "externalId": {
      "type": "string",
      "description": "External ID"
    }
  }
}

gorgias_delete_customer

Delete a customer from Gorgias.

Args:

id: Customer ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Customer ID to delete"
    }
  }
}

gorgias_merge_customers

Merge two customers into one.

Args:

targetId: The customer ID to keep (target)
sourceId: The customer ID to merge into target

Returns: The merged customer record.

{
  "type": "object",
  "required": [
    "targetId",
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "integer",
      "description": "Source customer ID to merge"
    },
    "targetId": {
      "type": "integer",
      "description": "Target customer ID to keep"
    }
  }
}

gorgias_list_events

List events from Gorgias with pagination and filtering.

Events represent actions that occurred in Gorgias (e.g., ticket created, message sent).

Args:

limit: Number of events to return (1-100, default: 20)
cursor: Pagination cursor from previous response
objectType: Filter by object type (e.g., 'ticket', 'message')
objectId: Filter by object ID
type: Filter by event type
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Event[], nextCursor } Markdown format: Formatted table of events

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Filter by event type"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of events to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "objectId": {
      "type": "integer",
      "description": "Filter by object ID"
    },
    "objectType": {
      "type": "string",
      "description": "Filter by object type"
    }
  }
}

gorgias_get_event

Get a single event by ID.

Args:

id: The event ID
format: Response format ('json' or 'markdown')

Returns: The event record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Event ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_list_integrations

List all integrations from Gorgias.

Integrations connect Gorgias to external services like Shopify, Magento, BigCommerce, etc.

Returns: JSON format: Array of integrations Markdown format: Formatted table of integrations

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_integration

Get a single integration by ID.

Args:

id: The integration ID
format: Response format ('json' or 'markdown')

Returns: The integration record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Integration ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_integration

Create a new HTTP integration in Gorgias.

Args:

name: Integration name (required)
type: Integration type (required)
httpUrl: HTTP endpoint URL
httpMethod: HTTP method (GET, POST, etc.)
httpHeaders: HTTP headers as key-value pairs (string values only)

Returns: The created integration record.

{
  "type": "object",
  "required": [
    "name",
    "type"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Integration name"
    },
    "type": {
      "type": "string",
      "description": "Integration type"
    },
    "httpUrl": {
      "type": "string",
      "description": "HTTP endpoint URL"
    },
    "httpMethod": {
      "type": "string",
      "description": "HTTP method"
    },
    "httpHeadersJson": {
      "type": "string",
      "description": "HTTP headers as JSON object"
    }
  }
}

gorgias_update_integration

Update an existing integration.

Args:

id: Integration ID to update
name: New integration name

Returns: The updated integration record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Integration ID to update"
    },
    "name": {
      "type": "string",
      "description": "Integration name"
    }
  }
}

gorgias_delete_integration

Delete an integration from Gorgias.

Args:

id: Integration ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Integration ID to delete"
    }
  }
}

gorgias_list_jobs

List background jobs from Gorgias with pagination.

Jobs represent background tasks like bulk operations or imports.

Args:

limit: Number of jobs to return (1-100, default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Job[], nextCursor } Markdown format: Formatted table of jobs

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of jobs to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_job

Get a single job by ID.

Args:

id: The job ID
format: Response format ('json' or 'markdown')

Returns: The job record with all available fields including status and progress.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Job ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_job

Create a new background job in Gorgias.

Args:

type: Job type (required)
paramsJson: Job parameters as JSON string (required)
scheduledDatetime: When to run the job (ISO datetime)

Returns: The created job record.

{
  "type": "object",
  "required": [
    "type",
    "paramsJson"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Job type"
    },
    "paramsJson": {
      "type": "string",
      "description": "Job parameters as JSON"
    },
    "scheduledDatetime": {
      "type": "string",
      "description": "When to run (ISO datetime)"
    }
  }
}

gorgias_cancel_job

Cancel a running job.

Args:

id: Job ID to cancel

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Job ID to cancel"
    }
  }
}

gorgias_list_macros

List macros from Gorgias with pagination.

Macros are pre-defined responses and actions that agents can use to respond quickly to common customer inquiries.

Args:

limit: Number of macros to return (1-100, default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Macro[], nextCursor } Markdown format: Formatted table of macros

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of macros to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_macro

Get a single macro by ID.

Args:

id: The macro ID
format: Response format ('json' or 'markdown')

Returns: The macro record with all available fields including actions.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Macro ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_macro

Create a new macro in Gorgias.

Args:

name: Macro name (required)
actions: Array of macro actions as JSON (required)
intent: Intent/category of the macro
language: Language code for the macro

Returns: The created macro record.

{
  "type": "object",
  "required": [
    "name",
    "actionsJson"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Macro name"
    },
    "intent": {
      "type": "string",
      "description": "Intent/category"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "actionsJson": {
      "type": "string",
      "description": "Macro actions as JSON array of {type, args} objects"
    }
  }
}

gorgias_update_macro

Update an existing macro.

Args:

id: Macro ID to update
name: New macro name
actionsJson: New array of macro actions as JSON
intent: New intent/category
language: New language code

Returns: The updated macro record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Macro ID to update"
    },
    "name": {
      "type": "string",
      "description": "Macro name"
    },
    "intent": {
      "type": "string",
      "description": "Intent/category"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "actionsJson": {
      "type": "string",
      "description": "Macro actions as JSON array"
    }
  }
}

gorgias_delete_macro

Delete a macro from Gorgias.

Args:

id: Macro ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Macro ID to delete"
    }
  }
}

gorgias_list_messages

List messages from Gorgias with pagination and filtering.

Returns a paginated list of messages. Use the cursor from the response to fetch the next page.

Args:

limit: Number of messages to return (1-100, default: 20)
cursor: Pagination cursor from previous response
ticketId: Filter by ticket ID
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Message[], nextCursor } Markdown format: Formatted table of messages

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of messages to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "ticketId": {
      "type": "integer",
      "description": "Filter by ticket ID"
    }
  }
}

gorgias_get_message

Get a single message by ID.

Args:

id: The message ID
format: Response format ('json' or 'markdown')

Returns: The message record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Message ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_message

Create a new message on a ticket.

Args:

ticketId: The ticket ID to add the message to
channel: The channel for the message (e.g., 'email', 'internal-note')
via: How the message was received (e.g., 'email', 'api', 'helpdesk')
bodyText: Message body (plain text)
bodyHtml: Message body (HTML, optional)
fromAgent: Whether this message is from an agent (default: true)
senderId: Sender user ID (for agent messages)
receiverId: Receiver user/customer ID
subject: Message subject (optional)

Returns: The created message record.

{
  "type": "object",
  "required": [
    "ticketId",
    "channel",
    "bodyText"
  ],
  "properties": {
    "via": {
      "type": "string",
      "default": "helpdesk",
      "description": "How the message was received"
    },
    "channel": {
      "type": "string",
      "description": "Channel for the message"
    },
    "subject": {
      "type": "string",
      "description": "Message subject"
    },
    "bodyHtml": {
      "type": "string",
      "description": "Message body (HTML)"
    },
    "bodyText": {
      "type": "string",
      "description": "Message body (plain text)"
    },
    "senderId": {
      "type": "integer",
      "description": "Sender user ID"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "fromAgent": {
      "type": "boolean",
      "default": true,
      "description": "Whether this is from an agent"
    },
    "receiverId": {
      "type": "integer",
      "description": "Receiver ID"
    }
  }
}

gorgias_delete_message

Delete a message from Gorgias.

Args:

id: Message ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Message ID to delete"
    }
  }
}

gorgias_list_rules

List automation rules from Gorgias with pagination.

Rules are automation workflows that trigger actions based on events (e.g., auto-tagging, auto-assignment).

Args:

limit: Number of rules to return (1-100, default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Rule[], nextCursor } Markdown format: Formatted table of rules

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of rules to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_create_rule

Create a new automation rule in Gorgias.

Args:

name: Rule name (required)
eventTypes: Event types that trigger the rule (required, e.g., 'ticket-created')
description: Rule description
code: Rule code (Python-like syntax)
codeAstJson: Rule code AST as JSON (alternative to code)
priority: Rule priority (lower runs first)

Returns: The created rule record.

{
  "type": "object",
  "required": [
    "name",
    "eventTypes"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Rule code"
    },
    "name": {
      "type": "string",
      "description": "Rule name"
    },
    "priority": {
      "type": "integer",
      "description": "Rule priority"
    },
    "eventTypes": {
      "type": "string",
      "description": "Event types (e.g., ticket-created)"
    },
    "codeAstJson": {
      "type": "string",
      "description": "Rule code AST as JSON"
    },
    "description": {
      "type": "string",
      "description": "Rule description"
    }
  }
}

gorgias_update_rule

Update an existing rule.

Args:

id: Rule ID to update
name: New rule name
eventTypes: New event types
description: New rule description
code: New rule code
codeAstJson: New rule code AST as JSON
priority: New rule priority

Returns: The updated rule record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Rule ID to update"
    },
    "code": {
      "type": "string",
      "description": "Rule code"
    },
    "name": {
      "type": "string",
      "description": "Rule name"
    },
    "priority": {
      "type": "integer",
      "description": "Rule priority"
    },
    "eventTypes": {
      "type": "string",
      "description": "Event types"
    },
    "codeAstJson": {
      "type": "string",
      "description": "Rule code AST as JSON"
    },
    "description": {
      "type": "string",
      "description": "Rule description"
    }
  }
}

gorgias_delete_rule

Delete a rule from Gorgias.

Args:

id: Rule ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Rule ID to delete"
    }
  }
}

gorgias_list_satisfaction_surveys

List satisfaction surveys from Gorgias with pagination.

Satisfaction surveys collect customer feedback after ticket resolution.

Args:

limit: Number of surveys to return (1-100, default: 20)
cursor: Pagination cursor from previous response
ticketId: Filter by ticket ID
customerId: Filter by customer ID
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: SatisfactionSurvey[], nextCursor } Markdown format: Formatted table of surveys

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of surveys to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "ticketId": {
      "type": "integer",
      "description": "Filter by ticket ID"
    },
    "customerId": {
      "type": "integer",
      "description": "Filter by customer ID"
    }
  }
}

gorgias_get_satisfaction_survey

Get a single satisfaction survey by ID.

Args:

id: The survey ID
format: Response format ('json' or 'markdown')

Returns: The satisfaction survey record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Survey ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_satisfaction_survey

Create a new satisfaction survey in Gorgias.

Args:

ticketId: The ticket ID to survey (required)
customerId: The customer ID (required)
shouldSendDatetime: When to send the survey (ISO datetime)

Returns: The created satisfaction survey record.

{
  "type": "object",
  "required": [
    "ticketId",
    "customerId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "customerId": {
      "type": "integer",
      "description": "Customer ID"
    },
    "shouldSendDatetime": {
      "type": "string",
      "description": "When to send (ISO datetime)"
    }
  }
}

gorgias_list_tags

List all tags from Gorgias.

Returns: JSON format: Array of tags Markdown format: Formatted table of tags

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_tag

Get a single tag by ID.

Args:

id: The tag ID
format: Response format ('json' or 'markdown')

Returns: The tag record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Tag ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_tag

Create a new tag in Gorgias.

Args:

name: Tag name (required)
description: Tag description
color: Tag color (hex code)

Returns: The created tag record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tag name"
    },
    "color": {
      "type": "string",
      "description": "Tag color (hex code)"
    },
    "description": {
      "type": "string",
      "description": "Tag description"
    }
  }
}

gorgias_update_tag

Update an existing tag.

Args:

id: Tag ID to update
name: New tag name
description: New tag description
color: New tag color (hex code)

Returns: The updated tag record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Tag ID to update"
    },
    "name": {
      "type": "string",
      "description": "Tag name"
    },
    "color": {
      "type": "string",
      "description": "Tag color (hex code)"
    },
    "description": {
      "type": "string",
      "description": "Tag description"
    }
  }
}

gorgias_delete_tag

Delete a tag from Gorgias.

Args:

id: Tag ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Tag ID to delete"
    }
  }
}

gorgias_merge_tags

Merge multiple tags into one.

Args:

primaryId: The tag ID to keep (primary)
secondaryIds: Array of tag IDs to merge into the primary

Returns: The merged tag record.

{
  "type": "object",
  "required": [
    "primaryId",
    "secondaryIds"
  ],
  "properties": {
    "primaryId": {
      "type": "integer",
      "description": "Primary tag ID to keep"
    },
    "secondaryIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Tag IDs to merge"
    }
  }
}

gorgias_list_teams

List all teams from Gorgias.

Returns: JSON format: Array of teams Markdown format: Formatted table of teams

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_team

Get a single team by ID.

Args:

id: The team ID
format: Response format ('json' or 'markdown')

Returns: The team record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Team ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_team

Create a new team in Gorgias.

Args:

name: Team name (required)
description: Team description
memberIds: Array of user IDs to add as members

Returns: The created team record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Team name"
    },
    "memberIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Member user IDs"
    },
    "description": {
      "type": "string",
      "description": "Team description"
    }
  }
}

gorgias_update_team

Update an existing team.

Args:

id: Team ID to update
name: New team name
description: New team description
memberIds: New array of member user IDs

Returns: The updated team record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Team ID to update"
    },
    "name": {
      "type": "string",
      "description": "Team name"
    },
    "memberIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Member user IDs"
    },
    "description": {
      "type": "string",
      "description": "Team description"
    }
  }
}

gorgias_delete_team

Delete a team from Gorgias.

Args:

id: Team ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Team ID to delete"
    }
  }
}

gorgias_create_view

Create a new view in Gorgias.

Args:

name: View name (required)
filters: Filter expression string
orderBy: Field to order by
orderDir: Order direction ('asc' or 'desc')
visibility: View visibility ('public', 'shared', 'private')
fields: Array of fields to display

Returns: The created view record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "View name"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to display"
    },
    "filters": {
      "type": "string",
      "description": "Filter expression"
    },
    "orderBy": {
      "type": "string",
      "description": "Field to order by"
    },
    "orderDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Order direction"
    },
    "visibility": {
      "enum": [
        "public",
        "shared",
        "private"
      ],
      "type": "string",
      "description": "View visibility"
    }
  }
}

gorgias_list_tickets

List tickets from Gorgias with pagination and filtering.

Returns a paginated list of tickets. Use the cursor from the response to fetch the next page.

Args:

limit: Number of tickets to return (1-100, default: 20)
cursor: Pagination cursor from previous response
status: Filter by status ('open' or 'closed')
assigneeUserId: Filter by assigned user ID
assigneeTeamId: Filter by assigned team ID
customerId: Filter by customer ID
channel: Filter by channel
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Ticket[], nextCursor } Markdown format: Formatted table of tickets

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of tickets to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "status": {
      "enum": [
        "open",
        "closed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "channel": {
      "type": "string",
      "description": "Filter by channel"
    },
    "customerId": {
      "type": "integer",
      "description": "Filter by customer ID"
    },
    "assigneeTeamId": {
      "type": "integer",
      "description": "Filter by assigned team ID"
    },
    "assigneeUserId": {
      "type": "integer",
      "description": "Filter by assigned user ID"
    }
  }
}

gorgias_get_ticket

Get a single ticket by ID with all messages included.

Args:

id: The ticket ID
format: Response format ('json' or 'markdown')

Returns: The ticket record with all available fields and messages.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_ticket

Create a new ticket in Gorgias.

Args:

channel: The channel for the ticket (e.g., 'email', 'chat', 'phone')
customerId: Customer ID (optional if customerEmail provided)
customerEmail: Customer email (used if customerId not provided)
subject: Ticket subject
messageBodyText: Initial message body (plain text)
messageBodyHtml: Initial message body (HTML, optional)
messageVia: How the message was received (e.g., 'email', 'api')

Returns: The created ticket record.

{
  "type": "object",
  "required": [
    "channel",
    "messageBodyText"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel for the ticket"
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject"
    },
    "customerId": {
      "type": "integer",
      "description": "Customer ID"
    },
    "messageVia": {
      "type": "string",
      "default": "api",
      "description": "How the message was received"
    },
    "customerEmail": {
      "type": "string",
      "description": "Customer email"
    },
    "messageBodyHtml": {
      "type": "string",
      "description": "Initial message body (HTML)"
    },
    "messageBodyText": {
      "type": "string",
      "description": "Initial message body (plain text)"
    }
  }
}

gorgias_update_ticket

Update an existing ticket.

Args:

id: Ticket ID to update
status: New status ('open' or 'closed')
priority: New priority ('low', 'normal', 'high', 'urgent')
assigneeUserId: New assignee user ID (null to unassign)
assigneeTeamId: New assignee team ID (null to unassign)
snoozeUntilDatetime: Snooze until this datetime (ISO format, null to unsnooze)

Returns: The updated ticket record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID to update"
    },
    "status": {
      "enum": [
        "open",
        "closed"
      ],
      "type": "string",
      "description": "New status"
    },
    "priority": {
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "type": "string",
      "description": "New priority"
    },
    "assigneeTeamId": {
      "type": "integer",
      "description": "New assignee team ID"
    },
    "assigneeUserId": {
      "type": "integer",
      "description": "New assignee user ID"
    }
  }
}

gorgias_delete_ticket

Delete a ticket from Gorgias.

Args:

id: Ticket ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID to delete"
    }
  }
}

gorgias_add_ticket_tags

Add tags to a ticket.

Args:

ticketId: The ticket ID
tagIds: Array of tag IDs to add

Returns: Confirmation of success.

{
  "type": "object",
  "required": [
    "ticketId",
    "tagIds"
  ],
  "properties": {
    "tagIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Tag IDs to add"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

gorgias_remove_ticket_tags

Remove tags from a ticket.

Args:

ticketId: The ticket ID
tagIds: Array of tag IDs to remove

Returns: Confirmation of success.

{
  "type": "object",
  "required": [
    "ticketId",
    "tagIds"
  ],
  "properties": {
    "tagIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Tag IDs to remove"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

gorgias_list_users

List users (agents) from Gorgias with pagination.

Returns a paginated list of users/agents. Use the cursor from the response to fetch the next page.

Args:

limit: Number of users to return (1-100, default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: User[], nextCursor } Markdown format: Formatted table of users

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of users to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_user

Get a single user (agent) by ID.

Args:

id: The user ID
format: Response format ('json' or 'markdown')

Returns: The user record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "User ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_update_view

Update an existing view.

Args:

id: View ID to update
name: New view name
filters: New filter expression
orderBy: New field to order by
orderDir: New order direction
visibility: New visibility
fields: New fields to display

Returns: The updated view record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "View ID to update"
    },
    "name": {
      "type": "string",
      "description": "View name"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to display"
    },
    "filters": {
      "type": "string",
      "description": "Filter expression"
    },
    "orderBy": {
      "type": "string",
      "description": "Field to order by"
    },
    "orderDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Order direction"
    },
    "visibility": {
      "enum": [
        "public",
        "shared",
        "private"
      ],
      "type": "string",
      "description": "View visibility"
    }
  }
}

gorgias_delete_view

Delete a view from Gorgias.

Args:

id: View ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "View ID to delete"
    }
  }
}

gorgias_list_view_items

List tickets matching a view's filters.

Args:

viewId: The view ID
limit: Number of tickets to return (1-100, default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Ticket[], nextCursor } Markdown format: Formatted table of tickets

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of tickets to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "viewId": {
      "type": "integer",
      "description": "View ID"
    }
  }
}

gorgias_list_widgets

List all widgets from Gorgias.

Widgets display custom information in the helpdesk UI (e.g., customer data from external systems).

Returns: JSON format: Array of widgets Markdown format: Formatted table of widgets

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gorgias_get_widget

Get a single widget by ID.

Args:

id: The widget ID
format: Response format ('json' or 'markdown')

Returns: The widget record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Widget ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

gorgias_create_widget

Create a new widget in Gorgias.

Args:

context: Widget context ('ticket', 'customer', or 'user') (required)
template: Widget template HTML (required)
order: Display order
integrationId: Associated integration ID

Returns: The created widget record.

{
  "type": "object",
  "required": [
    "context",
    "template"
  ],
  "properties": {
    "order": {
      "type": "integer",
      "description": "Display order"
    },
    "context": {
      "enum": [
        "ticket",
        "customer",
        "user"
      ],
      "type": "string",
      "description": "Widget context"
    },
    "template": {
      "type": "string",
      "description": "Widget template HTML"
    },
    "integrationId": {
      "type": "integer",
      "description": "Integration ID"
    }
  }
}

gorgias_update_widget

Update an existing widget.

Args:

id: Widget ID to update
context: New widget context
template: New widget template HTML
order: New display order

Returns: The updated widget record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Widget ID to update"
    },
    "order": {
      "type": "integer",
      "description": "Display order"
    },
    "context": {
      "enum": [
        "ticket",
        "customer",
        "user"
      ],
      "type": "string",
      "description": "Widget context"
    },
    "template": {
      "type": "string",
      "description": "Widget template HTML"
    }
  }
}

gorgias_delete_widget

Delete a widget from Gorgias.

Args:

id: Widget ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Widget ID to delete"
    }
  }
}