SuperOps MCP Servers

MCP (Model Context Protocol) servers for the SuperOps GraphQL API. Two dynamic tools powered by live schema introspection give AI assistants full access to every SuperOps API operation.

Which Package Do You Need?

SuperOps offers two products with separate APIs:

Package	Product	For	npm
superops-msp	SuperOps MSP	Managed Service Providers (IT companies serving multiple clients)
superops-it	SuperOps IT Teams	Internal IT Departments (single company)

SuperOps MSP

For Managed Service Providers - IT companies that manage technology for multiple businesses.

• Multi-tenant (one MSP, many clients)
• Client → Site → Assets/Tickets hierarchy
• Billing and invoicing features
• Install: bunx superops-msp@latest or npx superops-msp@latest

SuperOps IT Teams

For Internal IT Departments - IT teams within a single organization.

• Single-tenant (one company)
• Department → Assets/Tickets hierarchy
• Internal service desk focus
• Install: bunx superops-it@latest or npx superops-it@latest

Quick Start

claude mcp add superops-msp \
  -e SUPEROPS_API_KEY=your-api-key \
  -e SUPEROPS_SUBDOMAIN=your-subdomain \
  -- bunx superops-msp@latest

Get your API key from SuperOps Admin > API Settings. Your subdomain is the prefix from your SuperOps URL (e.g., acme from acme.superops.ai).

See the package READMEs for full configuration options:

• superops-msp README
• superops-it README

How It Works

Instead of hand-writing a tool for each API operation, these servers use live GraphQL introspection to discover every available operation at runtime. Two tools handle everything:

Tool	Purpose
superops-api	Execute any API operation by name
superops-api-schema	Discover operations, parameters, and usage examples

The schema is fetched lazily on first use and cached for the session. When SuperOps adds new API operations, they're available immediately — no code changes needed.

Coverage

The MSP API currently exposes 169 operations (97 queries + 72 mutations) across tickets, assets, clients, invoices, quotes, contracts, knowledge base, scripts, webhooks, approvals, and more.

API Endpoints

Product	US	EU
MSP	https://api.superops.ai/msp	https://euapi.superops.ai/msp
IT Teams	https://api.superops.ai/it	https://euapi.superops.ai/it

Repository Structure

superops-mcp/
├── packages/
│   ├── msp/          # superops-msp npm package
│   └── it/           # superops-it npm package

License

MIT