SuperOps IT Teams MCP Server

An MCP (Model Context Protocol) server that provides AI assistants with access to the SuperOps IT Teams GraphQL API documentation.

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

We recommend using bun for faster startup times - MCP servers start on every request, so speed matters.

bunx superops-it@latest

Or with npx:

npx superops-it@latest

Or install globally:

bun install -g superops-it@latest

npm install -g 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.

Available Tools

search_superops_api

Search the API documentation for queries, mutations, and types.

search_superops_api({ query: "ticket" })

get_superops_operation

Get full details of a specific query or mutation.

get_superops_operation({ name: "getTicket" })
get_superops_operation({ name: "getAsset" })

get_superops_type

Get full details of a type definition.

get_superops_type({ name: "Ticket" })
get_superops_type({ name: "Department" })

list_superops_operations

List all available operations.

list_superops_operations({ type: "queries" })
list_superops_operations({ type: "mutations" })
list_superops_operations({ type: "all" })

execute_graphql

Execute a GraphQL query or mutation against the SuperOps API. Requires environment variables (see Configuration).

execute_graphql({
  operation: "query { getTicket(id: \"123\") { id subject status } }"
})

execute_graphql({
  operation: "mutation createTicket($input: CreateTicketInput!) { createTicket(input: $input) { id } }",
  variables: { input: { subject: "New ticket", departmentId: "456" } }
})

API limits and notes:

• Maximum 800 API requests per minute
• Date/time values must be in UTC timezone with ISO format (e.g., 2022-04-10T10:15:30)
• Use null to clear/reset attribute values

API Endpoints

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

Example Usage

Once configured, ask Claude:

• "How do I create a ticket in SuperOps?"
• "What fields are available on the Asset type?"
• "Search for department-related operations"
• "Show me how to update a user"

Related

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

License

GPL-3.0