Connect
Optimize
Secure
Gorgias MCP Server
for AI Agents
Production-ready Gorgias MCP server with 69 extensible actions — plus built-in authentication, security, and optimized execution.
Gorgias MCP Server
Built by 
StackOne
StackOne 
Coverage
69 Agent Actions
Create, read, update, and delete across Gorgias — and extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your Gorgias MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →
Security
Agent Protection
Every Gorgias tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.
Prompt Injection Defense →
Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Gorgias call.
Tools Discovery →What is the Gorgias MCP Server?
A Gorgias MCP server lets AI agents read and write Gorgias data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's Gorgias MCP server ships with 69 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, and optimized agent context. Connect it from MCP clients like Claude Desktop, Cursor, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All Gorgias MCP Tools and Actions
Every action from Gorgias's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.
Customers
- Create Customer
Create a new customer
- List Customers
Retrieve a paginated list of all customers
- Get Customer
Retrieve a single customer by ID
- Update Customer
Update an existing customer
- Delete Customers
Delete one or more customers by their IDs
- Delete Customer
Delete a single customer by ID
Customer Custom Fields
- List Customer Custom Fields
List all custom fields for a customer
- Update Customer Custom Fields
Update custom fields for a customer
- Delete Customer Custom Field
Delete a customer's custom field value
Integrations
- Create Integration
Create a new integration
- List Integrations
Retrieve a paginated list of all integrations
- Get Integration
Retrieve a single integration by ID
- Update Integration
Update an existing integration
- Delete Integration
Delete an integration
Macros
- Create Macro
Create a new macro
- List Macros
Retrieve a paginated list of all macros
- Get Macro
Retrieve a single macro by ID
- Update Macro
Update an existing macro
- Delete Macro
Delete a macro
Messages
- Create Message
Create a new message on a ticket
- List Messages
Retrieve a paginated list of all messages
- Get Message
Retrieve a single message by ID
- Update Message
Update an existing message
- Delete Message
Delete a message
Rules
- Create Rule
Create a new rule
- List Rules
Retrieve a paginated list of all rules
- Get Rule
Retrieve a single rule by ID
- Update Rule
Update an existing rule
- Delete Rule
Delete a rule
Tags
- Create Tag
Create a new tag
- List Tags
Retrieve a paginated list of all tags
- Get Tag
Retrieve a single tag by ID
- Update Tag
Update an existing tag
- Delete Tag
Delete a tag
- Delete Tags
Delete multiple tags at once
Teams
- Create Team
Create a new team
- List Teams
Retrieve a paginated list of all teams
- Get Team
Retrieve a single team by ID
- Update Team
Update an existing team
- Delete Team
Delete a team
Tickets
- Create Ticket
Create a new support ticket
- List Tickets
Retrieve a paginated list of all tickets
- Get Ticket
Retrieve a single ticket by ID
- Update Ticket
Update an existing ticket
- Delete Ticket
Permanently delete a ticket
Ticket Tags
- List Ticket Tags
List all tags for a ticket
- Set Ticket Tags
Set a ticket's tags (replaces all existing tags)
Users
- Create User
Create a new user (agent)
- List Users
Retrieve a paginated list of all users (agents)
- Get User
Retrieve a single user by ID
- Update User
Update an existing user
- Delete User
Delete a user
Views
- Create View
Create a new view
- List Views
Retrieve a paginated list of all views
- Get View
Retrieve a single view by ID
- Update View
Update an existing view
- Delete View
Delete a view
View Items
- List View Items
Retrieve tickets in a view
- Search View Items
Search for items using custom view filters
Other (10)
- Add Tags To Ticket
Add tags to an existing ticket
- Get Account
Retrieve the current Gorgias account information including company details and settings
- List Settings
List account settings matching the given parameters
- Set Customer Data
Set a customer's data
- Update Rules Priorities
Update priorities for multiple rules at once
- Remove Tags From Ticket
Remove tags from an existing ticket
- Merge Customers
Merge two customers into one
- Archive Macros
Archive multiple macros at once
- Unarchive Macros
Unarchive multiple macros at once
- Merge Tags
Merge multiple tags into one
Set Up Your Gorgias MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to Gorgias in under 10 lines of code.
MCP Clients
Agent Frameworks
JSON{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}More Customer Support MCP Servers
Intercom
123+ actions
SurveyMonkey
104+ actions
Freshservice
84+ actions
ServiceNow
74+ actions
Freshdesk
71+ actions
Discourse
67+ actions
Dixa
65+ actions
Gorgias MCP Server Resources
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
Gorgias MCP Server FAQ
Gorgias MCP server vs direct API integration — what's the difference?
A Gorgias MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling Gorgias. A Gorgias MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling Gorgias at runtime. StackOne provides both.
How does Gorgias authentication work for AI agents?
Gorgias authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own Gorgias account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via
origin_owner_id.Are Gorgias MCP tools vulnerable to prompt injection?
Yes — Gorgias MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a Gorgias agent and how do I avoid it?
Context bloat happens when Gorgias tool schemas and API responses eat your Gorgias agent's memory, preventing it from reasoning effectively. A single Gorgias query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my Gorgias agent can access?
Yes — you can limit which actions your Gorgias agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my Gorgias MCP server?
Yes — you can create custom agent actions for your Gorgias MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research Gorgias's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a Gorgias MCP server?
Skip a Gorgias MCP server if your integration is purely software-to-software — direct Gorgias API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call Gorgias actions at runtime.
What AI frameworks and AI clients does the StackOne Gorgias MCP server support?
The StackOne Gorgias MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.