Connect SuperOps

SuperOps is a unified PSA + RMM platform for MSPs, exposed to StackJack through the SuperOps MSP GraphQL API. It covers tickets, assets and monitoring, clients/sites/users/contracts, tasks and…

Written By Christopher Scaminaci

Last updated 6 days ago

SuperOps is a unified PSA + RMM platform for MSPs, exposed to StackJack through the SuperOps MSP GraphQL API. It covers tickets, assets and monitoring, clients/sites/users/contracts, tasks and worklogs, invoicing, the service catalog, knowledge base, IT documentation, and RMM scripts.

Connecting SuperOps to StackJack gives your AI assistant a broad family of superops_ MCP tools — MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

Inventory managed assets — hardware, software, disks, patch status, and activity — plus alerts and available scripts
Manage clients and their sites, users, contracts, custom fields, and stages
Work tickets — read and create tickets, conversations, notes, and custom fields; triage against categories, priorities, statuses, and SLAs
Track time with tasks, worklog entries, and work statuses
Review invoices, taxes, and payment terms; the service catalog; knowledge base; and IT documentation
Act (on Pro plans) — create and update records, run a script on an asset, resolve alerts, and delete or restore items where SuperOps allows it
Run advanced GraphQL (on Pro plans) — two passthrough tools let your AI send a raw GraphQL query or mutation for anything the discrete tools don't cover

How StackJack authenticates to SuperOps

SuperOps uses a static, user-scoped API token — there is no OAuth login and nothing to refresh. Authentication needs two values, both required on every request:

API token — sent as a Bearer token. Generate it in SuperOps under Settings → My Profile → API token. Each user holds only one token at a time; regenerating replaces the previous one.
MSP subdomain — sent as the CustomerSubDomain value. Find it under Settings → MSP Information. A missing or wrong subdomain fails even when the token itself is valid.

The token inherits exactly the role of the SuperOps user who generated it — everything your AI can see or change is bounded by that user's permissions. Generate the token from a user whose access covers the data StackJack should reach.

Regions

SuperOps runs two data centers. StackJack shows a Region choice that sets the API host:

US — https://api.superops.ai/msp
EU — https://euapi.superops.ai/msp

Pick the region where your SuperOps account is hosted. The Instance URL field fills in from your choice — leave it as shown.

Before you begin

In StackJack: you need a role that can manage connectors (tenant Owner, a co-owner, or an Administrator).
In SuperOps: you need a user account that can generate an API token and whose role covers the data you want your AI to work with.
Know your region — US or EU, matching your SuperOps account.

Step 1 — Generate an API token in SuperOps

Sign in to SuperOps.
Go to Settings → My Profile → API token and click Generate.
Copy the token. Remember: each user holds only one API token at a time — regenerating invalidates the old one.

Step 2 — Find your MSP subdomain

Go to Settings → MSP Information.
Copy your subdomain (the CustomerSubDomain value). You'll paste this alongside the token.

Step 3 — Add the credentials in StackJack

In the StackJack portal, open Connectors.
Find the SuperOps card. Click How To Connect for the same steps inline, or Configure to enter the credentials.
Choose your Region (US or EU). The Instance URL field auto-fills — leave it as shown.
Enter your MSP subdomain and the API token.
Click Save.

What happens when you save

The subdomain and token are stored encrypted in Azure Key Vault — never in the StackJack database, and never shown back to you.
If this is the first time you configure SuperOps, a Free-tier subscription for the connector is created automatically so its Free tools work right away.
StackJack immediately live-validates the credentials by running a small technician-list query. This confirms all three of the token, the subdomain, and the region are correct together. Validation never blocks the save: you'll either see a success confirmation or a "saved but validation failed" warning with the reason.
The connector card shows the connection and validity status from then on.

How SuperOps returns results

SuperOps is a GraphQL API. Tools return the SuperOps response body as-is. Two things are worth knowing:

Errors come back in the body, not as a failure. When SuperOps can't fulfil a request (a bad filter, a missing record, a permission gap), it still returns a normal response containing an errors list describing the problem. Your AI reads that and can adjust — it is not a StackJack outage.
Clearing a field vs. leaving it alone. On update tools, leaving a field out keeps its current value; explicitly setting it to empty clears it. The write tools expose a way to name the fields you want cleared, so your AI won't wipe data it simply didn't mention.

Plans and available tools

Free includes reads across assets, alerts, scripts, clients, sites, users, contracts, tickets, tasks, worklogs, fields, the service catalog, invoices and taxes, knowledge base, IT documentation, ticket reference data, technicians, and business setup.
Pro adds create, update, delete/soft-delete/restore, script execution on an asset, alert resolution, and the advanced GraphQL passthrough tools.
Business offers the same tool set as Pro with a higher monthly call quota.

See the generated SuperOps tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.

SuperOps issues a single account-scoped API token (no per-user OAuth), so there is no per-user attribution — all AI traffic authenticates as the token's generating user. Current pricing and quotas are shown in the portal's Billing page and at checkout.

Safety note — powerful tools. A handful of Pro tools are irreversible or high-impact: deleting or soft-deleting clients, tickets, sites, users, fields, knowledge-base and IT-documentation items; and running a script on an asset, which executes code on the managed device. The two advanced GraphQL passthrough tools (superops_run_query and superops_run_mutation) can reach anything the token can, so they are Pro-gated and flagged as requiring confirmation. Scope your AI's access deliberately — use the tool selections on the MCP Setup page and the Permissions page to enable only the actions you want an AI to take.

Rate limits

SuperOps publishes an account-wide limit of 100 requests per minute for both its MSP and IT platforms. StackJack paces tool calls per tenant and honors any 429 backoff, so a long multi-page read is usually just slower. Pacing is not a guarantee: retries are bounded, so a wide enough read can still come back throttled or time out. Narrow the read, honour any retry delay the vendor sends, and check whether a write landed before repeating it — see Retrying a failed or timed-out write. StackJack's own pacing budget is 90 requests per minute per organization, below SuperOps' published ceiling, and a 429 backoff still covers traffic from anything else that uses the same token.

Rotating or replacing the credentials

The API token is the recovery secret. If you regenerate the token in SuperOps (or the generating user's access changes), the stored credential becomes invalid. To restore access, open Connectors → SuperOps → Configure in StackJack, paste the new token (re-select the region and re-enter the subdomain if needed), and Save.

Troubleshooting

Symptom	Likely cause	What to do
"Saved but validation failed" right after saving	Wrong region, a mis-typed token, or a missing/wrong subdomain	Re-check the region against your SuperOps account and re-enter both the subdomain and the token
Tools worked, then started failing	The API token was regenerated in SuperOps, so the old one is now invalid	Update the token in Connectors → SuperOps → Configure
A tool returns a permission error while others succeed	The generating user's role lacks access to that data	Generate the token from a SuperOps user whose role covers the data, or grant that user the access
A tool's result contains an `errors` list	SuperOps rejected that specific request (bad filter, missing record, or permission) — this is normal GraphQL behavior	Read the message in the `errors` entry; adjust the inputs or the user's permissions
Write or advanced tools missing from your AI's tool list	Connector is on the Free tier, or the tools aren't selected for your client	Upgrade the SuperOps connector plan and check your tool selections on the MCP Setup page

SuperOps tools

superops_ · 139 tools · Free 76 · Pro 63

Assets & Monitoring

Tool	What it does
`superops_assign_device_category` Pro · Write	Assign a device category to one or more assets.
`superops_get_asset` Free · Read-only	Fetch a single RMM asset (managed device) by its assetId.
`superops_get_asset_activity` Free · Read-only	Fetch the activity/event history for one asset by assetId.
`superops_get_asset_custom_fields` Free · Read-only	Fetch the custom-field values set on one asset by assetId.
`superops_get_asset_disk_details` Free · Read-only	Fetch disk/volume details for one asset by assetId (capacity, free space, file systems).
`superops_get_asset_info_by_tp_endpoint_ids` Free · Read-only	Resolve SuperOps assets from third-party (integration) endpoint IDs.
`superops_get_asset_list` Free · Read-only	List RMM assets (managed devices), paginated.
`superops_get_asset_patch_details` Free · Read-only	Fetch patch detail for one asset by assetId (the individual patches known for the device).
`superops_get_asset_patch_status` Free · Read-only	Fetch patch compliance/status for one asset by assetId (installed vs missing counts, last scan).
`superops_get_asset_software_list` Free · Read-only	Fetch the installed-software inventory for one asset by assetId.
`superops_get_asset_summary` Free · Read-only	Fetch a rollup/summary for one asset by assetId (health, status, last-reported).
`superops_get_asset_user_log` Free · Read-only	Fetch the logged-in-user history for one asset by assetId.
`superops_get_unmonitored_asset_list` Free · Read-only	List assets that are NOT under monitoring, paginated.
`superops_run_script_on_asset` Pro · Destructive	Execute an RMM script on an asset (endpoint).
`superops_soft_delete_asset` Pro · Destructive	Soft-delete an RMM asset by assetId (moves it to a recoverable deleted state).
`superops_update_asset` Pro · Write	Update attributes of an existing RMM asset.

Alerts & Scripts

Tool	What it does
`superops_create_alert` Pro · Write	Raise a new RMM alert.
`superops_get_alert_list` Free · Read-only	List RMM alerts, paginated.
`superops_get_alerts_for_asset` Free · Read-only	Fetch the RMM alerts scoped to a single asset by assetId.
`superops_get_script_list` Free · Read-only	List RMM scripts, paginated.
`superops_get_script_list_by_type` Free · Read-only	List RMM scripts filtered to a single script type, paginated.
`superops_resolve_alerts` Pro · Write	Resolve (close) one or more RMM alerts by their alertIds.

Clients

Tool	What it does
`superops_create_client` Pro · Write	Create a client (account).
`superops_create_client_v2` Pro · Write	Create a client (account) using the current-stable V2 schema — PREFERRED over superops_create_client.
`superops_get_client` Free · Read-only	Fetch a single client (account) by its accountId (from superops_get_client_list).
`superops_get_client_list` Free · Read-only	List clients (accounts), paginated.
`superops_hard_delete_clients` Pro · Destructive	PERMANENTLY delete one or more clients (accounts).
`superops_restore_clients` Pro · Write	Restore one or more soft-deleted clients (accounts) back to active state (reverses superops_soft_delete_clients; does NOT recover hard-deleted clients).
`superops_soft_delete_clients` Pro · Destructive	Soft-delete one or more clients (accounts) — they are moved to a deleted state and can be restored with superops_restore_clients.
`superops_update_client` Pro · Write	Update a client (account).

Client Custom Fields

Tool	What it does
`superops_create_client_custom_field` Pro · Write	Create a client custom-field definition.
`superops_get_client_custom_field` Free · Read-only	Fetch a single client custom-field definition/value.
`superops_get_client_custom_field_list` Free · Read-only	List client custom-field definitions/values, paginated.

Client Stages

Tool	What it does
`superops_get_client_stage_list` Free · Read-only	List client lifecycle stages (the account-stage lookup used when creating/updating a client), paginated.

Client Sites

Tool	What it does
`superops_create_client_site` Pro · Write	Create a client site.
`superops_delete_client_sites` Pro · Destructive	Delete one or more client sites.
`superops_get_client_site` Free · Read-only	Fetch a single client site by its id (from superops_get_client_site_list).
`superops_get_client_site_list` Free · Read-only	List client sites, paginated.
`superops_update_client_site` Pro · Write	Update a client site.

Client Users

Tool	What it does
`superops_create_client_user` Pro · Write	Create a client user (requester).
`superops_create_client_user_associations` Pro · Write	Create one or more client↔user associations (link a client user to a client, and optionally a site, with a role).
`superops_delete_client_user` Pro · Destructive	Delete a single client user (requester).
`superops_delete_client_user_associations` Pro · Destructive	Delete one or more client↔user associations (unlink users from clients/sites).
`superops_get_client_user` Free · Read-only	Fetch a single client user (requester) by userId (from superops_get_client_user_list).
`superops_get_client_user_association_list` Free · Read-only	List client↔user associations, paginated.
`superops_get_client_user_list` Free · Read-only	List client users (requesters), paginated.
`superops_update_client_user` Pro · Write	Update a client user (requester).
`superops_update_client_user_associations` Pro · Write	Update one or more client↔user associations (e.g. change a user's role or site link).

Client Contracts

Tool	What it does
`superops_create_client_contract` Pro · Write	Create a client contract.
`superops_get_client_contract` Free · Read-only	Fetch a single client contract by its contractId (from superops_get_client_contract_list).
`superops_get_client_contract_list` Free · Read-only	List client contracts, paginated.
`superops_update_client_contract` Pro · Write	Update a client contract.

Tickets

Tool	What it does
`superops_create_ticket` Pro · Write	Create a ticket.
`superops_create_ticket_conversation` Pro · Destructive	Add a public conversation/reply to a ticket.
`superops_create_ticket_custom_field` Pro · Write	Create a ticket custom-field definition.
`superops_create_ticket_note` Pro · Write	Add an internal note to a ticket (not visible to the requester).
`superops_get_ticket` Free · Read-only	Fetch a single ticket by its ticketId.
`superops_get_ticket_conversation_list` Free · Read-only	List the public conversation/reply thread for a ticket.
`superops_get_ticket_custom_field` Free · Read-only	Fetch a single ticket custom-field definition/value.
`superops_get_ticket_custom_field_list` Free · Read-only	List ticket custom fields (paginated).
`superops_get_ticket_list` Free · Read-only	List tickets (paginated).
`superops_get_ticket_note_list` Free · Read-only	List the internal notes on a ticket.
`superops_hard_delete_tickets` Pro · Destructive	PERMANENTLY delete one or more trashed tickets.
`superops_restore_tickets` Pro · Write	Restore one or more soft-deleted (trashed) tickets.
`superops_soft_delete_tickets` Pro · Destructive	Soft-delete (move to trash) one or more tickets.
`superops_update_ticket` Pro · Write	Update a ticket.

Tasks & Worklogs

Tool	What it does
`superops_create_task` Pro · Write	Create a task.
`superops_create_worklog_entries` Pro · Write	Add one or more worklog (time) entries.
`superops_delete_worklog_entry` Pro · Destructive	Permanently delete a single worklog (time) entry.
`superops_get_task` Free · Read-only	Fetch a single task by its taskId (from superops_get_task_list).
`superops_get_task_list` Free · Read-only	List tasks (paginated).
`superops_get_work_status_list` Free · Read-only	List the configured work statuses (the timer/work states used on worklog entries), paginated.
`superops_get_worklog_entries` Free · Read-only	List worklog (time) entries, paginated.
`superops_update_worklog_entry` Pro · Write	Update a single worklog (time) entry.

Fields

Tool	What it does
`superops_create_field` Pro · Write	Create a field definition.
`superops_delete_field` Pro · Destructive	Permanently delete a field definition.
`superops_get_all_fields` Free · Read-only	Fetch all field definitions for a module.
`superops_get_field` Free · Read-only	Fetch a single field definition.
`superops_get_fields` Free · Read-only	Fetch one or more field definitions by their identifiers (the getFields(input: [FieldIdentifierInput!]!) batch read).
`superops_update_field` Pro · Write	Update a field definition.

Service Catalog

Tool	What it does
`superops_create_service_catalog_item` Pro · Write	Create a service catalog item.
`superops_create_service_category` Pro · Write	Create a service category.
`superops_create_service_item` Pro · Write	Create a service item.
`superops_get_offered_items` Free · Read-only	List items offered to a client or contract (paginated).
`superops_get_service_catalog_item` Free · Read-only	Fetch a single service catalog item by ID.
`superops_get_service_catalog_item_list` Free · Read-only	List service catalog items (paginated).
`superops_get_service_category_list` Free · Read-only	List service categories (paginated).
`superops_get_service_item` Free · Read-only	Fetch a single service item by ID.
`superops_get_service_item_list` Free · Read-only	List service items (paginated).
`superops_update_service_catalog_item` Pro · Write	Update a service catalog item.

Financial

Tool	What it does
`superops_create_invoice` Pro · Destructive	Create an invoice.
`superops_create_tax` Pro · Write	Create a tax definition.
`superops_get_invoice` Free · Read-only	Fetch a single invoice by ID.
`superops_get_invoice_item_list` Free · Read-only	List the line items of an invoice (paginated).
`superops_get_invoice_list` Free · Read-only	List invoices (paginated).
`superops_get_payment_method_list` Free · Read-only	List configured payment methods (paginated).
`superops_get_payment_term_list` Free · Read-only	List configured payment terms (paginated).
`superops_get_tax` Free · Read-only	Fetch a single tax definition by ID.
`superops_get_tax_list` Free · Read-only	List tax definitions (paginated).
`superops_update_invoice` Pro · Write	Update an invoice.

Knowledge Base

Tool	What it does
`superops_create_kb_article` Pro · Write	Create a knowledge base article.
`superops_create_kb_collection` Pro · Write	Create a knowledge base collection.
`superops_delete_kb_article` Pro · Destructive	Permanently DELETE a knowledge base article by ID.
`superops_delete_kb_collection` Pro · Destructive	Permanently DELETE a knowledge base collection by ID.
`superops_get_kb_item` Free · Read-only	Fetch a single knowledge base item (article or collection) by ID.
`superops_get_kb_items` Free · Read-only	List knowledge base items — articles and collections (paginated).
`superops_update_kb_article` Pro · Write	Update a knowledge base article.
`superops_update_kb_collection` Pro · Write	Update a knowledge base collection.

IT Documentation

Tool	What it does
`superops_create_it_documentation` Pro · Write	Create an IT-documentation record.
`superops_delete_it_documentation` Pro · Destructive	Permanently DELETE an IT-documentation record by ID.
`superops_get_it_documentation` Free · Read-only	Fetch a single IT-documentation record by ID.
`superops_get_it_documentation_categories` Free · Read-only	List IT-documentation categories (paginated).
`superops_get_it_documentation_list` Free · Read-only	List IT-documentation records (paginated).
`superops_update_it_documentation` Pro · Write	Update an IT-documentation record.

Ticket Reference Data

Tool	What it does
`superops_create_categories` Pro · Write	Create one or more ticket categories (batch).
`superops_create_causes` Pro · Write	Create one or more ticket cause values (batch).
`superops_create_status` Pro · Write	Create a ticket status.
`superops_get_category_list` Free · Read-only	List the account's ticket categories (paginated).
`superops_get_cause_list` Free · Read-only	List the account's ticket cause values (paginated).
`superops_get_impact_list` Free · Read-only	List the account's ticket impact values (paginated).
`superops_get_priority_list` Free · Read-only	List the account's ticket priorities (paginated).
`superops_get_resolution_code_list` Free · Read-only	List the account's ticket resolution codes (paginated).
`superops_get_status_list` Free · Read-only	List the account's ticket statuses (paginated).
`superops_get_urgency_list` Free · Read-only	List the account's ticket urgency values (paginated).

Technicians & Teams

Tool	What it does
`superops_create_technician` Pro · Write	Create a technician (internal MSP user).
`superops_delete_technician` Pro · Destructive	Delete a technician (internal MSP user).
`superops_get_business_function_list` Free · Read-only	List business functions configured on the account (paginated).
`superops_get_designation_list` Free · Read-only	List technician designations (job titles) configured on the account (paginated).
`superops_get_requester_role_list` Free · Read-only	List requester roles (permission profiles for client-side users) on the account (paginated).
`superops_get_team_list` Free · Read-only	List technician teams on the account (paginated).
`superops_get_technician_group_list` Free · Read-only	List technician groups on the account (paginated).
`superops_get_technician_list` Free · Read-only	List technicians (internal MSP users) on the account (paginated).
`superops_get_technician_role_list` Free · Read-only	List technician roles (permission profiles for internal users) on the account (paginated).
`superops_update_technician` Pro · Write	Update a technician (internal MSP user).

Business Setup

Tool	What it does
`superops_get_device_categories` Free · Read-only	List RMM device categories configured on the account.
`superops_get_holiday_list` Free · Read-only	List the account's holiday calendar entries (paginated).
`superops_get_sla_list` Free · Read-only	List SLA (service-level agreement) definitions on the account (paginated).

GraphQL Passthrough

Tool	What it does
`superops_run_mutation` Pro · Destructive	Run an ARBITRARY GraphQL mutation document against the SuperOps /msp endpoint and return the raw JSON body verbatim.
`superops_run_query` Pro · Destructive	Run an ARBITRARY GraphQL query document against the SuperOps /msp endpoint and return the raw JSON body verbatim.

Still need help? Ask the team