
OneUptime MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and VS Code work with OneUptime: look into incidents, query logs and traces, acknowledge alerts and set up monitors.
This is OneUptime's own MCP server, built into every OneUptime instance at the /mcp address, so there is nothing to install. You sign in with your OneUptime account in the browser and pick a project and whether the assistant may change things. The tools cover create, read, update and delete for many record types, plus telemetry queries.
On OneUptime Cloud, connecting an assistant needs the Growth plan or higher. Choose Read only when you sign in if you only want it to look.
Good for
- On-call engineers who want an assistant to triage incidents and alerts
- Platform teams who query logs, metrics and traces by asking in plain words
- Teams that run OneUptime status pages and want to post updates from chat
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install OneUptime MCP
Claude Code
- 1
Copy this prompt.
Add the OneUptime MCP server to Claude Code. Run this command: claude mcp add --transport http oneuptime https://oneuptime.com/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Sign-in with the vendor account (OAuth).
Built from the package data we hold. Not yet tested by us.
Tools
Shows which project and user you are connected as
Returns the project your credentials belong to and, when you signed in, who you are and whether you can make changes. Call it first.
Try: “Which OneUptime project am I connected to?”
Network ·
oneuptime_whoamiExplains what the OneUptime tools can do
Returns guidance about the available resources and common operations. It works without signing in.
Try: “What can you do in OneUptime?”
Network ·
oneuptime_helpLists the kinds of records you can manage
Lists every resource kind and the operations it supports. It works without signing in.
Try: “What kinds of things can I manage in OneUptime?”
Network ·
oneuptime_list_resourcesLists and searches incidents
Searches incidents with filtering, paging and sorting, and returns the matches with a total count.
Try: “Show me open incidents from the last 24 hours.”
Network ·
list_incidentsOpens a new incident
Creates an incident in your project and returns it with its ID.
Try: “Create an incident for the checkout API being down, severity critical.”
Write ·
create_incidentMarks an incident as being worked on
Moves an incident to the project's Acknowledged state, like pressing Acknowledge in the dashboard.
Try: “Acknowledge incident INC-142.”
Write ·
acknowledge_incidentResolves an incident
Moves an incident to the Resolved state, like pressing Resolve in the dashboard.
Try: “Resolve incident INC-142, the fix is deployed.”
Write ·
resolve_incidentAdds a note to an incident
Adds a note that is internal to your team or public on the status page. Markdown works.
Try: “Add an internal note to INC-142 saying we rolled back the release.”
Write ·
add_incident_noteEdits an incident
Changes the fields of an existing incident.
Try: “Change the severity of INC-142 to major.”
Write ·
update_incidentPermanently deletes an incident
Deletes an incident. The docs say this cannot be undone.
Try: “Delete the test incident I created earlier.”
Delete ·
delete_incidentLists and searches alerts
Searches alerts with filtering, paging and sorting.
Try: “Which alerts are still unacknowledged?”
Network ·
list_alertsMarks an alert as being worked on
Moves an alert to the Acknowledged state.
Try: “Acknowledge the CPU alert on web-1.”
Write ·
acknowledge_alertResolves an alert
Moves an alert to the Resolved state.
Try: “Resolve the CPU alert on web-1.”
Write ·
resolve_alertAdds a note to an alert
Adds a note to an alert.
Try: “Add a note to that alert: restarted the service.”
Write ·
add_alert_noteLists and searches monitors
Searches monitors with filtering, paging and sorting.
Try: “Which monitors are currently down?”
Network ·
list_monitorsCreates a monitor
Creates a monitor in your project.
Try: “Create a monitor for https://example.com.”
Write ·
create_monitorEdits a monitor
Changes the configuration of an existing monitor.
Try: “Change the check interval of the example.com monitor to 1 minute.”
Write ·
update_monitorPermanently deletes a monitor
Deletes a monitor and cannot be undone.
Try: “Delete the old staging monitor.”
Delete ·
delete_monitorLists status pages
Searches the status pages in your project.
Try: “List my status pages.”
Network ·
list_status_pagesPosts an announcement on a status page
Creates a status page announcement.
Try: “Post an announcement that we have scheduled downtime tonight.”
Write ·
create_status_page_announcementSchedules a maintenance window
Creates a scheduled maintenance event.
Try: “Schedule maintenance for Saturday 2am to 4am.”
Write ·
create_scheduled_maintenance_eventLists on-call duty policies
Searches the on-call duty policies in your project, which define who gets paged and in what order. It lists the policies, not who is on call this minute.
Try: “List our on-call duty policies.”
Network ·
list_on_call_duty_policiesLists teams
Searches the teams in your project.
Try: “List all teams.”
Network ·
list_teamsSearches your logs
Queries log data. The tool warns that telemetry tables are large, so always filter by a time range and keep limits small.
Try: “Show error logs from the payments service in the last 15 minutes.”
Network ·
list_logsQueries your metrics
Queries metric data with filters.
Try: “Show CPU metrics for web-1 for the last hour.”
Network ·
list_metricsQueries your traces
Queries trace spans with filters.
Try: “Find slow spans over 2 seconds in the last hour.”
Network ·
list_spansLists exceptions your apps raised
Queries exception data.
Try: “What new exceptions appeared since the last deploy?”
Network ·
list_exception_instancesShows the check history of monitors
Queries the log of monitor checks.
Try: “Why did the example.com monitor fail at noon?”
Network ·
list_monitor_logsLists security events
Queries security event data.
Try: “Show security events from today.”
Network ·
list_security_eventsCounts incidents
Returns how many incidents match a filter. Similar count tools exist for other record kinds.
Try: “How many incidents did we have this month?”
Network ·
count_incidentsShows a public status page, no sign-in needed
Returns current status, resources, active incidents, maintenance and announcements for a public status page. It works without an API key.
Try: “Is status.example.com reporting any issues?”
Network ·
get_public_status_page_overviewLists incidents on a public status page
Returns the incidents of a public status page without sign-in.
Try: “What incidents has status.example.com reported?”
Network ·
get_public_status_page_incidentsLists maintenance on a public status page
Returns scheduled maintenance of a public status page without sign-in.
Try: “Is there maintenance planned on status.example.com?”
Network ·
get_public_status_page_scheduled_maintenanceLists announcements on a public status page
Returns the announcements of a public status page without sign-in.
Try: “Any announcements on status.example.com?”
Network ·
get_public_status_page_announcements
Listed by the running server in our sandbox
Permissions
high risk · 4 things to watch
High risk
With a full sign-in or an admin API key, the assistant can create, change and delete incidents, monitors, status pages and more, using your permissions. Choose Read only when you authorize, or use a Viewer API key, unless you need changes.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
It can delete records, not just read them
Delete tools exist for the 43 record kinds it manages. Authorize as Read only, or use a Viewer-level key. github.com
Never give an agent a master API key
The docs warn that a master key is accepted too and gives admin access to the whole instance. Use a project key with the least access. github.com
It can change live incidents and status pages
Tools acknowledge and resolve incidents, post notes and announcements, and public notes reach your customers. Review before approving. github.com
Unauthenticated tools are public
Help tools and public status page tools work without signing in. Status page owners can turn MCP access off per page. github.com
Security advisories
No published security advisories for the MCP server as of Nov 1, 2026.
92 other advisories are about the wider oneuptime project, not this MCP server. See them on GitHub
Technical details
| Turning on read-only | When you sign in, choose Read only. The docs say read-only clients can only use the get, list and count tools, and writes are refused by the server and the API. |
|---|---|
| Talks to | oneuptime.com, or your own OneUptime address if self-hosted |
| Sign-in and keys | OAuth 2.1 sign-in in your browser (no key stored), or a project API key sent in the x-api-key header for unattended agents. |
| Scopes |
|
Questions
Is the OneUptime MCP server official?
Yes. OneUptime builds it into its own product, on Cloud and on self-hosted instances.
What is the OneUptime MCP server URL?
On OneUptime Cloud it is https://oneuptime.com/mcp. On a self-hosted instance, use your own domain with /mcp on the end.
Do I need an API key?
No for normal use: your app opens OneUptime in the browser so you can sign in. An API key is for unattended agents, and goes in the x-api-key header.
Does it work on the free plan?
The docs say that on OneUptime Cloud it needs the Growth plan or higher, the same plans that have API keys. Self-hosted instances have it built in.
Can it be read-only?
Yes. Choose Read only when you authorize, or use a Viewer API key. Then only the get, list and count tools work.
Can I use it without signing in?
Only for a few tools: help, resource lists and public status page lookups work without credentials.
How many tools does it have?
About 290, because most record kinds have create, get, list, update, delete and count tools. This page lists the main ones, so the list is partial.
Information
updated Nov 2, 2026
- Publisher
- Official
- Endpoint
https://oneuptime.com/mcp- Transport
- Streamable HTTP
- Auth
- OAuth
- Version
- 14.0.98
- Last commit
- Oct 31, 2026
- Open issues
- 219
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.