MCP Server
The Oppex MCP server lets an AI assistant, such as Claude Code, work with Oppex for you. You ask in plain language, and the assistant chooses the tools below to answer or act. Each page describes one tool: what it does, what it needs, who can use it, and example prompts.
To connect an assistant, see Working with Oppex MCP Server.
How the tools behave
- The assistant acts as you. Every tool runs with your Oppex account, so you can only do what your role allows in Oppex. Actions are recorded under your name.
- One workspace per connection. Every tool works in the workspace that was active when you approved the connection. To use another workspace, switch it in Oppex and reconnect.
- One incident at a time. There are no bulk actions. For a group of incidents or people, the assistant lists them, asks you to confirm, and then acts on each one.
- Changes are confirmed first. The assistant confirms before it changes anything, unless your prompt already named the action and the incident, as in "Acknowledge incident cacgichh-efbg-jv3t1ufo."
Incident tools
| Tool | Page | What it does |
|---|---|---|
oppex.incidents.listAssigned | List my incidents | Lists incidents assigned to you. |
oppex.incidents.listAll | List all incidents | Lists every incident you can see in the workspace. |
oppex.incidents.search | Search incidents | Finds incidents by words in their title. |
oppex.incident.acknowledge | Acknowledge an incident | Acknowledges an incident and stops its escalation. |
oppex.incident.snooze | Snooze an incident | Pauses paging on an incident assigned to you. |
oppex.incident.resolve | Resolve an incident | Resolves an incident without an RCA. |
oppex.incident.resolveWithRCA | Resolve with an RCA | Records a root cause analysis and resolves the incident. |
oppex.incident.updateRCA | Update an RCA | Changes an incident's existing RCA. |
oppex.incident.updateRCAByIdentifier | Update an RCA by incident or external ID | Adds or changes an RCA, using the Oppex ID or the monitoring tool's alert ID. |
oppex.incident.addNote | Add a note | Adds a note to an incident. |
oppex.incident.listNotes | List notes | Reads an incident's notes. |
oppex.incident.getAnalysis | Get the AI analysis | Reads the AI Responder's analysis of an incident and the logs behind it. |
On-call tools
| Tool | Page | What it does |
|---|---|---|
oppex.oncall.whoIsOnCallForService | Who is on call for a service | Shows who is on call now at each level of a service. |
oppex.oncall.whoIsOnCallByServiceKey | Who is on call by integration key | The same, for the service that owns an integration key. |
oppex.oncall.whoIsOnCallByUser | A person's on-call assignments | Shows what a person is on call for, and whether they are on call now. |
People and workspace tools
| Tool | Page | What it does |
|---|---|---|
oppex.admin.listWorkspaces | List workspaces | Lists the workspaces you can access. |
oppex.admin.listUsers | List users | Lists or searches the people in the workspace. |
oppex.admin.inviteUser | Invite a user | Emails an invitation to someone new. |
oppex.admin.addUser | Add a user to a workspace | Gives an existing user access to a workspace, or changes their role there. |
oppex.admin.removeUser | Remove a user from a workspace | Removes someone from one workspace. |
oppex.admin.deboardUser | Deactivate a user | Deactivates someone's account across the organization. |
Account and settings tools
| Tool | Page | What it does |
|---|---|---|
oppex.user.getCurrentUser | Who am I connected as | Shows the account, role and workspace the connection uses. |
oppex.admin.getConfig | Read a workspace setting | Reads one incident setting, such as whether an RCA is required. |
Prompts that combine tools
The assistant chains tools together when one prompt needs several steps. For example:
| Prompt | Tools the assistant uses |
|---|---|
| "Acknowledge the Hyperdrive Failure incident and tell me who is on call at the next level." | Search incidents, Acknowledge an incident, Who is on call for a service |
| "Take over the checkout latency incident: summarize the notes and the AI analysis, then add a note that I'm on it." | Search incidents, List notes, Get the AI analysis, Add a note |
| "Resolve my incident on Millennium Falcon Worker with an RCA based on what we fixed today." | List my incidents, Read a workspace setting, Resolve with an RCA |
| "Han Solo has left. Show what they're still on call for, then deactivate their account." | List users, A person's on-call assignments, Deactivate a user |
What the assistant cannot do
The tools cannot create incidents, reassign or escalate them, or create or change services, schedules, escalation policies and settings. Do those in Oppex.