Gorgias-MCP-Server

# Gorgias MCP Server An MCP server for interacting with the Gorgias helpdesk API. This server provides tools and resources for managing tickets, customers, and other Gorgias functionality. ## Setup 1. Clone this repository 2. Install dependencies: ``` npm install ``` 3. Create a `.env` file based on `.env.example` with your Gorgias credentials: ``` GORGIAS_DOMAIN=your-domain.gorgias.com GORGIAS_USERNAME=your-username GORGIAS_API_KEY=your-api-key ``` Or for OAuth apps: ``` GORGIAS_DOMAIN=your-domain.gorgias.com GORGIAS_ACCESS_TOKEN=your-oauth-access-token ``` ## Running the Server Start the server: ``` npm run dev ``` ## Testing with MCP Inspector Test the server with the MCP Inspector: ``` npm run inspect ``` This will open a web interface where you can test all the available tools and resources. ## Available Tools ### Tickets - `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 ### Customers - `list_customers`: List customers from Gorgias - `get_customer`: Get a specific customer by ID ## Available Resources - `gorgias://tickets`: List all tickets - `gorgias://ticket/{id}`: Get a specific ticket by ID ## Authentication This server supports two authentication methods: 1. API Key authentication (username/API key) 2. OAuth token authentication Configure your preferred method in the `.env` file.