# OneUptime — MCP server card for AI agents

Manage incidents, alerts, monitors, status pages, on-call and telemetry in OneUptime.

Registry name: `com.oneuptime/mcp` · category: Other · version 17.0.0 · updated 2026-11-19

## Connect
- Remote (Claude Code): `claude mcp add --transport http oneuptime https://oneuptime.com/mcp`

## Facts
- Repository: https://github.com/OneUptime/oneuptime (7,826 stars)
- Website: https://oneuptime.com/docs/ai/mcp-server

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-oneuptime-mcp/


## OneUptime: incidents, monitors and status pages from AI chat

OneUptime watches your websites and services, raises incidents and alerts, pages whoever is on call and runs public status pages. This server lets Claude, Cursor or another AI assistant do that work for you. It can look into an incident, search logs, acknowledge an alert or set up a monitor, with your permissions.

### Where to use it
- Handle an incident from chat: When something breaks, ask the assistant for the newest incident, take it, read the related logs, post an update for customers and close it when fixed.
- Search logs and traces in plain words: Ask "which errors did the checkout service log in the last hour" and the assistant filters logs, traces and errors for you. It only reads; nothing is changed.
- Set up monitoring for a new site: Ask the assistant to create a monitor for your new website and add it to the status page, instead of clicking through the dashboard.
- Post a maintenance notice: Before planned downtime, have the assistant create a maintenance window and an announcement on your public status page.
- Check another service's status page: Ask whether a service you depend on has an outage right now. This works for any public OneUptime status page, with no account.
- A morning summary for the on-call person: Each morning, ask for open incidents, unacknowledged alerts and who is on call today, read-only, before the stand-up. (idea, not from the official pages)

### How to start
- Add the server with its address only; there is nothing to install.

```
claude mcp add --transport http oneuptime https://oneuptime.com/mcp
```

- Run /mcp in Claude Code, sign in to OneUptime in the browser, choose the project and Read only or Read and write, then Authorize.
- Ask the assistant to call oneuptime_whoami to confirm the project, then work with incidents and monitors.

### License
The server code is open source under Apache 2.0, apart from the separate enterprise folder. Using it on OneUptime Cloud needs the Growth plan or higher; the free plan cannot connect an assistant.

### Good to know
- On OneUptime Cloud the assistant can only connect on the Growth plan or above. Below it, key-based calls are refused with a message naming the plan.
- Many tools change real things. They can delete records, change an incident's state, page someone on call or post to your public status page.
- Choose Read only when you sign in if the assistant should only look. Every tool that changes something is then refused.
- Never give an assistant a master key, which opens the whole installation. Use a project key with the least access it needs.
- A sign-in works for one project and lapses after 30 days without use; connect again for another project.

Checked 2026-11-10 against: https://registry.modelcontextprotocol.io/v0.1/servers?search=com.oneuptime/mcp&version=latest, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/README.md, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/LICENSE, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/README.md, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/server.json, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/Tools/ToolGenerator.ts, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/Tools/WorkflowTools.ts, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/Tools/HelperTools.ts, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/Tools/PublicStatusPageTools.ts, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/Tools/ToolAnnotations.ts, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/MCP/Handlers/ToolHandler.ts, https://github.com/OneUptime/oneuptime/blob/b9268cdf143016312ab058d45bb13406e8526629/packages/App/FeatureSet/Docs/Content/en/ai/mcp-server.md, https://oneuptime.com/docs/ai/mcp-server, https://oneuptime.com/pricing

### Mistakes to avoid
- Don't: Give the agent a OneUptime master API key → Do: Create a project API key with the least access (Viewer for reading) under Project Settings, Advanced, API Keys (A master key is accepted on the same header and grants admin access to the whole instance.)
- Don't: add_incident_note with visibility "public" for a working note → Do: Use the default visibility "internal"; post public only after the person approves the text (Public notes are posted to the status page that customers read.)
- Don't: Filter with MongoDB syntax such as {"title": {"$regex": "db"}} → Do: Use OneUptime operators: {"title": {"_type": "Search", "value": "database"}}; ask oneuptime_describe_resource for a field's operators (Other filter shapes are refused before they reach the API.)
- Don't: Retry a tool call that answered 402 → Do: Stop and tell the person the project must be on the Growth plan or above; the same key works again after an upgrade (Below Growth every key-based tool answers 402 and the agent is told not to retry.)
- Don't: Expect heavy fields (JSON, long text, HTML) in get_ and list_ answers by default → Do: Name them in the select array (By default heavy columns are left out of the answer.)

### Questions
- Do I need an API key? No. Give the client the address and sign in to OneUptime in the browser; a project API key is only for agents that run unattended.
- Can I keep the assistant read-only? Yes. Choose Read only when you sign in, or give an API key the Viewer access; then create, update, delete, acknowledge and resolve are refused.
- Does it work with a self-hosted OneUptime? Yes. Every instance serves it at /mcp on its own address; replace oneuptime.com with your domain.
- How do I see or cut off a connected assistant? Project Settings, AI, MCP Server lists connected clients; Disconnect stops one at once.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
