SuperOps IT Teams MCP Server

An MCP server that gives AI assistants full access to the SuperOps IT Teams GraphQL API through two dynamic tools powered by live schema introspection.

What is SuperOps IT Teams?

SuperOps IT Teams is for internal IT departments - IT teams within a single organization. Key concepts:

• Single-tenant: One company, one IT department
• Department-based: Data organized by Department → Assets/Tickets
• Internal focus: Service desk for employees, not external clients

Installation

bunx superops-it@latest

Or with npx:

npx superops-it@latest

Configuration

Claude Code

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

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "superops-it": {
      "command": "bunx",
      "args": ["superops-it@latest"],
      "env": {
        "SUPEROPS_API_KEY": "your-api-key",
        "SUPEROPS_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SUPEROPS_API_KEY | Yes | Your SuperOps API key | | SUPEROPS_SUBDOMAIN | Yes | Your subdomain (e.g., acme from acme.superops.ai) | | SUPEROPS_REGION | No | us (default) or eu | | SUPEROPS_TIMEOUT | No | Request timeout in ms (default: 30000) | | SUPEROPS_READ_ONLY | No | Set to true to block mutations |

Get your API key from SuperOps Admin > API Settings.

Tools

superops-api

Execute any SuperOps API operation by name. The server builds the GraphQL query automatically from the introspected schema.

superops-api({ operation: "getTicketList", params: { page: 1, pageSize: 10 } })
superops-api({ operation: "getAsset", params: { assetId: "12345" } })
superops-api({ operation: "getPriorityList" })

superops-api-schema

Discover available operations and their parameter schemas.

superops-api-schema()                                    → Category summary
superops-api-schema({ category: "Ticket" })              → Operations in category
superops-api-schema({ operation: "getTicket" })           → Full parameter details
superops-api-schema({ examples: true })                   → Usage patterns and gotchas
superops-api-schema({ operation: "getTicket", examples: true })  → Schema + example

Transport

| Mode | Flag | Use Case | |------|------|----------| | stdio | (default) | Claude Code, Claude Desktop | | Streamable HTTP | --http | Web clients, containers | | Legacy SSE | --sse | Older MCP clients |

API Limits

• Maximum 800 API requests per minute
• Date/time values must be in UTC with ISO format (e.g., 2026-03-17T10:15:30)

API Endpoints

• US: https://api.superops.ai/it
• EU: https://euapi.superops.ai/it

Related

• superops-msp - For SuperOps MSP (managed service providers)

License

MIT