MCP Servers

Gorgias MCP Server

mattcoatsworth

Developer Tools

README

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.

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

MCP Package Docs Server

Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.

Claude Code MCP

An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.

@kazuph/mcp-taskmanager

Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.

Linear MCP Server

Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.

mermaid-mcp-server

A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.

Jira-Context-MCP

MCP server to provide Jira Tickets information to AI coding agents like Cursor

Linear MCP Server

A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.

Sequential Thinking MCP Server

This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.