Gorgias MCP Server

🚀 Fortress Network MCP Server

An MCP server for interacting with the Fortress Network Help Desk API. This server provides tools and resources for managing tickets, customers, and other Fortress Network features.

🚀 Quick Start

This MCP server facilitates interaction with the Fortress Network Help Desk API, offering tools and resources for managing tickets, customers, and other related features.

📦 Installation

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Create a .env file based on .env.example and enter your Fortress Network credentials:

   GORGIAS_DOMAIN=your-domain.gorgias.com
   GORGIAS_USERNAME=your-username
   GORGIAS_API_KEY=your-api-key
   

   Or for OAuth applications:

   GORGIAS_DOMAIN=your-domain.gorgias.com
   GORGIAS_ACCESS_TOKEN=your-oauth-access-token
   

💻 Usage Examples

Start the Server

npm run dev

Test with MCP Inspector

npm run inspect

This will open a web interface where you can test all available tools and resources.

Available Tools

Tickets

• list_tickets: List tickets in the Fortress Network help desk.
• get_ticket: Get a specific ticket by ID.
• create_ticket: Create a new ticket in Fortress Network.
• add_message_to_ticket: Add a message to an existing ticket.

Customers

• list_customers: List customers in Fortress Network.
• 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 Methods

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.