Gorgias-MCP-Server

The Gorgias MCP Server is designed to facilitate seamless interaction with the Gorgias helpdesk API. It offers a suite of tools and resources that allow users to manage tickets, customers, and other functionalities within the Gorgias platform. The server supports two authentication methods: API Key and OAuth token, ensuring secure access to the Gorgias API. Users can easily set up the server by cloning the repository, installing dependencies, and configuring the environment with their Gorgias credentials. Once set up, the server can be run in development mode, and users can test its capabilities using the MCP Inspector, which provides a web interface for testing available tools and resources.

Features

• Supports API Key and OAuth token authentication for secure access.
• Provides tools for managing tickets and customers within Gorgias.
• Includes a web interface for testing via MCP Inspector.
• Easy setup with environment configuration for Gorgias credentials.
• Runs in development mode for testing and integration.

MCP Tools

• list_tickets: List tickets from Gorgias helpdesk
• get_ticket: Get a specific ticket by ID
• create_ticket: Create a new ticket in Gorgias
• add_message_to_ticket: Add a message to an existing ticket
• list_customers: List customers from Gorgias
• get_customer: Get a specific customer by ID

MCP Resources

• {'name': 'gorgias://tickets', 'description': 'List all tickets'}
• {'name': 'gorgias://ticket/{id}', 'description': 'Get a specific ticket by ID'}

Usage with Different Platforms

nodejs

javascript
// Clone the repository
// Install dependencies
npm install

// Create a .env file with your Gorgias credentials
// Start the server
npm run dev

// Test with MCP Inspector
npm run inspect