MCP Server

The Supp MCP (Model Context Protocol) server lets AI assistants interact with your support system directly. Classify messages, manage tickets, execute triggers, and monitor analytics — from your browser, terminal, or code editor.

Installation

You don't need a terminal or code editor. Supp works wherever you use AI — including Claude.ai in your browser. Authentication happens automatically via OAuth — no API keys to copy or manage.

Claude.ai (browser)

No terminal needed. In Claude.ai, go to Settings → Add custom connector. Set the name to supp and the URL to:

text
https://mcp.supp.support/mcp

Click Connect to authenticate with your Supp account via OAuth. After that, you can manage your entire support system through conversation.

Claude Code (terminal)

Run this in your terminal:

bash
claude mcp add --transport http supp https://mcp.supp.support/mcp

The first time you use an MCP tool, your browser will open to log in. After that, authentication is automatic.

Cursor

Add to .cursor/mcp.json in your project root:

json
{
  "mcpServers": {
    "supp": {
      "url": "https://mcp.supp.support/mcp"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{
  "mcpServers": {
    "supp": {
      "serverUrl": "https://mcp.supp.support/mcp"
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json in your project root:

json
{
  "servers": {
    "supp": {
      "type": "http",
      "url": "https://mcp.supp.support/mcp"
    }
  }
}

Other MCP Clients

Any MCP client that supports HTTP transport and OAuth can connect. Point it to:

text
https://mcp.supp.support/mcp

Your browser will open to authenticate. No API keys or headers needed.

How auth works: Supp uses OAuth so you authenticate via your browser — no API keys in config files. Your MCP client opens a browser window, you log in to your Supp account, and the connection is authorized automatically.

Available Tools

The MCP server exposes these tools to your AI assistant:

ToolDescription
supp_helpLearn about Supp, available tools, and how to use them
supp_ticketsList classified support tickets with filtering
supp_ticketGet full details of a single ticket
supp_ticket_resolveMark a ticket as resolved
supp_classifyTest classification against a message (no ticket created)
supp_intentsList all 315 supported intents with categories
supp_triggersList all automation triggers
supp_trigger_createCreate a new trigger (intent to action mapping)
supp_trigger_updateUpdate an existing trigger
supp_trigger_deleteDelete a trigger
supp_trigger_simulateSimulate a trigger against sample text (dry run, no side effects)
supp_queueList pending approvals
supp_approveApprove a pending action (executes immediately)
supp_rejectReject a pending action
supp_integrationsList connected services
supp_connectGet setup instructions for a service
supp_disconnectRemove an integration
supp_statsOverview metrics (conversations, resolution rate, costs)
supp_stats_intentsIntent breakdown with counts
supp_stats_triggersTrigger performance metrics
supp_priority_scoreScore a message's priority (low/medium/high/critical)
supp_classify_with_priorityClassify intent + score priority in one call
supp_priority_rulesList blanket priority rules
supp_priority_rule_setCreate or update a blanket priority rule
supp_priority_rule_deleteDelete a blanket priority rule
supp_routing_bulkBulk-update routing for multiple intents at once
supp_routing_categoryConfigure routing for an entire category
supp_routing_listList all routing rules grouped by category
supp_categoriesList all intent categories and counts
supp_escalatedList escalated tickets needing response
supp_escalation_respondRespond to an escalated ticket
supp_balanceCheck current balance and spend
supp_spend_capView or update spend cap settings
supp_docs_connectLink a documentation source for templates
supp_trigger_executeExecute integration actions FOR REAL (creates issues, sends messages)
supp_stats_exportExport support data as CSV or JSON
supp_refundSubmit a refund request for unauthorized charges
supp_refund_statusCheck the status of refund requests

Example Workflows

Set up bug report routing

Ask your AI assistant:

text
"Create a trigger that routes bug_report intents to Linear
with 0.85 confidence threshold, and also notify #bugs on Slack"

Review and approve pending actions

Ask your AI assistant:

text
"Show me pending approvals and approve any refund
requests under $50 that have high confidence"

Test classification

Ask your AI assistant:

text
"Classify this message: 'I was charged twice for my subscription'"

Set up priority-based routing

Ask your AI assistant:

text
"Set up a blanket priority rule that pages on-call via Slack
for any critical message. Also configure all billing intents
to only fire their routing rules for high and critical priority."