Tools Reference

Complete reference for all 43 Supp MCP tools.

Classification

supp_classify

Classify a message into one of 315 intents. Costs $0.20 per call.

// Returns
{
  "intent": "bug_report",
  "confidence": 0.91,
  "all_intents": [
    {"intent": "bug_report", "confidence": 0.91},
    {"intent": "performance_issue", "confidence": 0.68}
  ]
}

supp_classify_with_priority

Classify intent AND score priority in a single call. Costs $0.23 per call ($0.20 classification + $0.03 priority).

// Returns
{
  "intent": "api_troubleshooting",
  "confidence": 0.88,
  "priority": "high",
  "all_intents": [...],
  "cost": 0.23,
  "new_balance": 4.77
}

supp_intents

List all 315 supported intents, optionally filtered by category.

// Returns
{
  "total": 315,
  "categories": [
    {
      "category": "technical_support",
      "count": 47,
      "intents": [
        {"id": "bug_report", "description": "Customer reporting a software bug"},
        {"id": "performance_issue", "description": "..."}
      ]
    }
  ]
}

supp_categories

List all 13 intent categories with counts. No parameters.

// Returns
{
  "total_intents": 315,
  "categories": [
    {"id": "technical_support", "name": "Technical Support", "intent_count": 47},
    {"id": "billing_payment", "name": "Billing & Payment", "intent_count": 31}
  ]
}

Tickets

supp_tickets

List support tickets with filters.

// Returns
{
  "tickets": [
    {
      "id": "conv_abc",
      "message": "The app keeps crashing",
      "intent": "bug_report",
      "confidence": 0.91,
      "status": "open",
      "user_email": "customer@example.com",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ]
}

supp_ticket

Get full details of a single ticket.

// Returns
{
  "id": "conv_abc",
  "message": "The app keeps crashing",
  "intent": "bug_report",
  "confidence": 0.91,
  "status": "open",
  "user_email": "customer@example.com",
  "created_at": "2025-01-15T10:30:00Z",
  "trigger_fired": "trg_xyz",
  "action_status": "completed"
}

supp_ticket_resolve

Mark a ticket as resolved.

Triggers (Routing Rules)

supp_triggers

List your custom triggers. Default: top 20.

supp_trigger_get

Get a single trigger by ID.

Returns full trigger config including pipeline, template, approval settings, priority filter, and collect fields.

supp_trigger_create

Create a new routing rule.

Pipeline actions (for actions parameter):

[
  {"type": "mcp_action", "provider": "github", "config": {"repo": "org/app", "labels": "bug"}},
  {"type": "mcp_action", "provider": "slack", "config": {"channel": "#alerts"}},
  {"type": "template", "template": "We've filed a ticket for your issue."}
]

escalate_human is terminal — nothing can follow it in the pipeline.

Collect fields:

[
  {"key": "email", "label": "Your email", "type": "email", "required": true},
  {"key": "description", "label": "Describe the issue", "type": "text", "required": false}
]

supp_trigger_update

Update an existing trigger. Only specified fields are changed.

supp_trigger_delete

Delete a trigger permanently.

supp_trigger_simulate

Dry-run a trigger against sample text. No side effects, no charges.

// Returns
{
  "would_fire": true,
  "intent_matched": "bug_report",
  "confidence": 0.89,
  "action_preview": "Create GitHub issue",
  "approval_required": false
}

supp_trigger_execute

Execute a trigger's integration actions for real. Creates actual issues, sends real messages.

Routing (Bulk Configuration)

supp_routing_list

List the routing table grouped by category.

Without category: returns compact summary (count per category). With category: returns full details for every intent in that category.

supp_routing_bulk

Apply routing config to multiple intents at once.

Mode 1 — Same config for all:

Mode 2 — Per-intent overrides:

supp_routing_category

Apply routing config to all intents in entire categories.

Priority Scoring

supp_priority_score

Score a message's urgency. Costs $0.03 per call.

// Returns
{"priority": "critical", "cost": 0.03}

Priority levels: low, medium, high, critical.

supp_priority_rules

List blanket priority rules (one per priority level). No parameters.

supp_priority_rule_set

Create or update a blanket priority rule.

supp_priority_rule_delete

Delete a blanket priority rule.

supp_priority_scoring_settings

Get or set global priority scoring.

supp_priority_scoring_intent

Override priority scoring for specific intents.

Integrations

supp_integrations

List all connected and available integrations. No parameters.

Returns connected (active services) and available (services you can connect with setup hints).

supp_connect

Get the OAuth URL or setup instructions for a service.

OAuth services return a URL you can open to authorize. Non-OAuth services return instructions.

supp_disconnect

Disconnect a service.

Escalation

supp_escalated

List escalated tickets needing human attention.

supp_escalation_respond

Send a response to an escalated ticket. Saved as a draft for human review.

Approvals

supp_queue

List pending approval requests. No parameters.

supp_approve

Approve a pending action. Executes the configured action immediately.

supp_reject

Reject a pending action. Ticket stays open.

Analytics

supp_stats

Overview metrics for a time period.

// Returns
{
  "period": "week",
  "total_tickets": 142,
  "resolved": 118,
  "escalated": 24,
  "auto_resolution_rate": 0.83,
  "avg_confidence": 0.82
}

supp_stats_intents

Intent frequency breakdown.

supp_stats_triggers

Trigger performance metrics (fires, resolutions, rejections).

supp_stats_export

Export data as CSV or JSON.

Billing

supp_balance

Check current credit balance and recent charges. No parameters.

supp_spend_cap

View or update spend caps for an API key.

supp_refund

Submit a refund request.

supp_refund_status

Check status of refund requests. No parameters.

API Keys

supp_api_key_create

Generate a new API key pair. Keys are shown once and cannot be retrieved again.

// Returns
{
  "publishable_key": "pk_live_abc123...",
  "secret_key": "sk_live_xyz789...",
  "label": "Production",
  "warning": "Save these keys now — they cannot be retrieved again."
}

• pk_live_ key: safe for client-side (widget embedding)
• sk_live_ key: server-side only (keep private)

Knowledge

supp_docs_connect

Link a documentation source.

supp_docs

List connected documentation sources and their sync status. No parameters.

Help

supp_help

On-demand documentation about Supp.