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

       

       GORGIAS_DOMAIN=your-domain.gorgias.com

       GORGIAS_USERNAME=your-username

       GORGIAS_API_KEY=your-api-key

       

       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.