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.