# OnlineOrNot MCP Server

Connects AI assistants to OnlineOrNot for querying uptime checks, status-page incidents, maintenance windows, and status pages through the Model Context Protocol.

Connections use OnlineOrNot OAuth or an API token. OAuth-capable clients open an authentication flow when they first connect.

## Connecting

The MCP server address is:

`https://mcp.onlineornot.com/mcp`

Machine-readable server metadata is available at:

`https://mcp.onlineornot.com/.well-known/mcp/server-card.json`

Append `?codemode=false` for clients that cannot run Code Mode. This exposes one generated MCP tool per OnlineOrNot API endpoint and increases the tool-list token cost.

## Authentication

OAuth-capable clients can connect directly to the MCP server address. The protected-resource metadata is available at:

`https://mcp.onlineornot.com/.well-known/oauth-protected-resource/mcp`

API tokens use the HTTP `Authorization` header:

```text
Authorization: Bearer <your-onlineornot-api-token>
```

API tokens and OAuth access tokens are secrets. Do not place them in source control or expose them in agent output.

Credentials retain their OnlineOrNot organization, role, plan, endpoint, and grant restrictions. Use only the required `READ` grants for investigative agents. Mutations require the corresponding `EDIT` grant.

## Setup Instructions

### Claude Code

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

### Cursor

Use the "Install in Cursor" button on the website, or add this configuration to Cursor's MCP settings:

```json
{
  "mcpServers": {
    "onlineornot": {
      "url": "https://mcp.onlineornot.com/mcp"
    }
  }
}
```

### VS Code

Use the "Install in VSCode" button on the website, or select "MCP: Add Server" from the Command Palette and enter:

`https://mcp.onlineornot.com/mcp`

### Codex

```bash
codex mcp add onlineornot --url https://mcp.onlineornot.com/mcp
```

### Other Clients

Any MCP-compatible client can connect using the HTTP transport at the MCP server address above. Installation instructions for additional clients are available on the website.

## Capabilities

- Uptime checks
- Heartbeat monitors
- Status-page incidents
- Maintenance windows
- Status pages
- API tokens
- Webhooks
- Organization users and invitations
- Audit logs (`PEOPLE:READ` required)

Status-page incidents and incident updates use the `STATUS_PAGES` grant. The exact endpoint catalog is generated from the current OnlineOrNot OpenAPI description.

## Resources

- [OnlineOrNot MCP installation](https://mcp.onlineornot.com/)
- [Connect an MCP client](https://onlineornot.com/docs/how-to/mcp/connect)
- [MCP reference](https://onlineornot.com/docs/reference/mcp)
- [MCP server card](https://mcp.onlineornot.com/.well-known/mcp/server-card.json)
- [OnlineOrNot API documentation](https://developers.onlineornot.com/)
- [OnlineOrNot service status](https://status.onlineornot.com/)