PlugWiki
OneUptime logo

OneUptime MCP Server: Setup for Claude, Cursor and Other Apps

OfficialRemote
Gethttps://oneuptime.com/mcponeuptime/oneuptime

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.

Install OneUptime MCP

Claude Code

  1. 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. 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_whoami

  • Explains 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_help

  • Lists 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_resources

  • Lists 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_incidents

  • Opens 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_incident

  • Marks 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_incident

  • Resolves 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_incident

  • Adds 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_note

  • Edits an incident

    Changes the fields of an existing incident.

    Try: “Change the severity of INC-142 to major.”

    Write · update_incident

  • Permanently deletes an incident

    Deletes an incident. The docs say this cannot be undone.

    Try: “Delete the test incident I created earlier.”

    Delete · delete_incident

  • Lists and searches alerts

    Searches alerts with filtering, paging and sorting.

    Try: “Which alerts are still unacknowledged?”

    Network · list_alerts

  • Marks an alert as being worked on

    Moves an alert to the Acknowledged state.

    Try: “Acknowledge the CPU alert on web-1.”

    Write · acknowledge_alert

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

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-onlyWhen 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 tooneuptime.com, or your own OneUptime address if self-hosted
Sign-in and keysOAuth 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
  • mcp:read (get, list and count tools)

  • mcp:write (adds every tool that changes something)

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

WebsiteGitHubOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. OneUptime MCP server docs · github.com
  2. Live tools/list on the OneUptime Cloud MCP endpoint (289 tools, server 14.0.100, 2026-11-02) · oneuptime.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.