SkillFoxx

OneUptime MCP

The built-in OneUptime MCP: an agent works incidents, reads logs and traces, acknowledges alerts and sets up monitors.

  • 7,816 ★ on the repository
  • Last commit
MCP serverOfficial

Extended access

Why this level

  • With write permission the agent acknowledges and resolves alerts and incidents, changes monitors and deletes records.
  • Logs, traces and exceptions go into the model context.
All reasons and checks

oneuptime/oneuptimeAuthor:OneUptime

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/oneuptime

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • With write permission the agent acknowledges and resolves alerts and incidents, changes monitors and deletes records.
  • Logs, traces and exceptions go into the model context.

This is third-party code. Review the repository files before installing.

What it does

The MCP server is part of every OneUptime instance at `/mcp` next to the dashboard: `https://oneuptime.com/mcp` in the cloud and `https://your-domain/mcp` on a self-hosted install. Nothing needs installing, and the server speaks streamable HTTP without sessions. Tools cover monitors, incidents, alerts, teams and on-call, status pages, scheduled maintenance and telemetry. There are create, get, list, update, delete and count tools for 53 kinds of record and read-only list and count tools for 9 kinds of telemetry (logs, metrics, traces, exceptions and more). Read tools carry `readOnlyHint` and modifying ones `destructiveHint`. Sign-in uses OAuth 2.1 as the user, or a project API key for unattended agents.

Who it is for. On-call engineers and SRE teams working in OneUptime who want to handle incidents and telemetry from Claude Code, Cursor or VS Code with Copilot.

Good fit when

  • An alert fired and the agent looks for the cause in logs and traces and then acknowledges the alert.
  • An incident has to be declared, annotated and driven to resolution without switching to the dashboard.
  • A monitor for a new service is created from a description and its status and history are checked.
  • A status page gets an announcement and scheduled maintenance is set up from the chat.

Not a fit when

  • There is no OneUptime project: the server works with your project and its permissions.
  • The agent must change nothing: choose read-only at consent or a key with the Viewer role.
  • A cloud plan below Growth: MCP client connection is unavailable there, as are API keys.

Example request

Look at open incidents from the last day, find the cause of the latest one in logs and traces and tell me which alerts to acknowledge.

MCP

Transport
http
Authentication
OAuth

Environment variables

x-api-key secret
Project API key for unattended agents; without it sign-in uses OAuth

Limitations

On OneUptime Cloud MCP client connection is available on the Growth plan and above, like API keys. OAuth sign-in applies to one project, and a second project needs a new connection. Read-only mode blocks create, update, delete, acknowledge and resolve tools. A master API key opens the whole instance and must not be given to agents: use a project key with minimal rights. Without sign-in or a key only public status page tools are available. A client unused for 30 days has to sign in again.

How to disable. In Project Settings, AI, MCP Server click Disconnect for the connected client: it stops working at once. Revoke API keys in Project Settings, Advanced, API Keys and remove the server entry from the client settings.

FAQ

How do I connect Claude Code?

Run `claude mcp add --transport http oneuptime https://oneuptime.com/mcp`, then `/mcp` and choose `oneuptime` to sign in.

How do I give the agent read-only access?

Choose Read only at authorization: only `get_`, `list_` and `count_` tools work and the rest are refused by the server and the API. For an API key choose the Viewer role.

How do I connect an unattended agent?

Create a key in Project Settings, Advanced, API Keys and send it in the `x-api-key` header. The Viewer role is enough for reading.

What works without sign-in?

Only the public status page tools.

Does it work on a self-hosted install?

Yes, every OneUptime instance has the server: `https://your-domain/mcp`.

Discussion

No questions or reviews yet.

MCP servers
Official

Monitoring and status page service with an MCP server: an agent reads check state and manages incidents.

MCP serverExtended access55

Independent Datadog MCP server: an agent reads incidents, monitors, logs, metrics, traces and RUM and schedules downtimes.

MCP serverExtended access143
Official

The Superlog MCP server: an agent searches incidents, queries logs, traces and metrics and manages alerts and dashboards.

MCP serverExtended access1.5K

README in short

The README lists platform features and mentions the MCP server in one line. Details are in the `ai/mcp-server` documentation.

README badge

Report a problem