SuperOps MCP server

SuperOps.ai MCP Server

MCP server for Claude that provides tools to interact with the SuperOps.ai PSA/RMM platform using their GraphQL API.

One-Click Deployment

Operator note — GitHub Packages authentication. This package is published

to the @wyre-ai scope on GitHub Packages, which requires an

authentication token on every install (GitHub Packages has no anonymous reads,

even for public packages). Create a GitHub Personal Access Token with the

read:packages scope and supply it to the cloud builder:

- Cloudflare Workers — set a build variable named NODEAUTHTOKEN to your PAT.

- DigitalOcean App Platform — set a build-time secret named GITHUB_TOKEN to your PAT.

For local installs, run export NODEAUTHTOKEN=$(gh auth token) before npm install.

Features

• Decision Tree Architecture: Navigate to domains (clients, tickets, assets, technicians) to see relevant tools
• Lazy Loading: Domain modules load on-demand for faster startup
• Full CRUD Operations: List, get, create, and update entities
• GraphQL Support: Use custom queries for advanced operations
• Interactive Ticket Card (MCP Apps): ticket results render as an interactive card in MCP Apps hosts — neutral by default, brandable via window.BRAND injection or MCPBRAND env vars

Interactive Ticket Card (MCP Apps)

superopsticketsget renders as an interactive card in MCP Apps hosts (Claude Desktop/web) with an in-card "Add note" round-trip via superopsticketsaddnote that always posts internal-only notes (isPublic: false); plain-JSON behavior is unchanged in other hosts. The card is neutral by default and brandable via window.BRAND injection or MCPBRAND env vars (MCPBRANDNAME, MCPBRANDLOGOURL, MCPBRANDPRIMARYCOLOR, MCPBRANDACCENTCOLOR, MCPBRANDBG, MCPBRANDTEXT) — no rebuild needed.

Installation

# The @wyre-ai scope lives on GitHub Packages and needs a token to install:
export NODE_AUTH_TOKEN=$(gh auth token)
npm install @wyre-ai/superops-mcp

Configuration

Set the following environment variables:

export SUPEROPS_API_TOKEN="your-api-token"
export SUPEROPS_SUBDOMAIN="yourcompany"
export SUPEROPS_REGION="us"  # or "eu" for EU region

Getting Your API Token

1. Log in to SuperOps.ai
2. Click settings icon > "My Profile"
3. Navigate to "API token" tab
4. Click "Generate token"
5. Copy and securely store the token

Usage with Claude Desktop

Add to your claudedesktopconfig.json:

{
  "mcpServers": {
    "superops": {
      "command": "npx",
      "args": ["@wyre-ai/superops-mcp"],
      "env": {
        "SUPEROPS_API_TOKEN": "your-api-token",
        "SUPEROPS_SUBDOMAIN": "yourcompany",
        "SUPEROPS_REGION": "us"
      }
    }
  }
}

Available Domains & Tools

Navigation

• superops_navigate - Navigate to a domain
• superops_back - Return to main menu
• superopstestconnection - Test API connectivity

Clients Domain

• superopsclientslist - List clients with filters
• superopsclientsget - Get client details
• superopsclientssearch - Search clients by name

Tickets Domain

• superopsticketslist - List tickets with filters
• superopsticketsget - Get ticket details
• superopsticketscreate - Create a new ticket
• superopsticketsupdate - Update ticket status/assignment
• superopsticketsadd_note - Add note to ticket
• superopsticketslog_time - Log time on ticket

Assets Domain

Shortened. The full README is on GitHub.