# MCP & AI

Source: https://getuptimely.com/docs/mcp-and-ai

> The remote MCP server, Connected AI apps, and the in-app copilot.

AI agents can operate Uptimely through a first-class Model Context Protocol
surface — the same domain logic as the dashboard, behind the same
authorization.

<ConnectAgentPill />

## Connect your coding agent [#connect-your-coding-agent]

A coding agent can also set itself up: Claude Code, Codex, Cursor or
OpenCode can fetch [the setup prompt](https://getuptimely.com/agent-setup/prompt.md)
and configure itself: it adds the remote MCP server, and — where you want
programmatic access too — walks through minting a project API key for the
[REST API and SDK](/api). See the [setup guides](https://getuptimely.com/agent-setup)
for the exact steps per client, including the ones without a one-shot prompt
(claude.ai, ChatGPT).

## Remote MCP server [#remote-mcp-server]

Uptimely hosts a remote MCP endpoint at
`https://app.getuptimely.com/api/mcp` (Streamable HTTP) with OAuth 2.1
authorization: connect it from any MCP-capable client (Claude, ChatGPT, and
other agent hosts), approve the consent screen, and the agent gets tools
for anything you can do in Uptimely — monitors, incidents, alerts, status pages, billing, your team, connections, API keys and support. See the [tool reference](/docs/mcp-tools).

Authorizations are visible and revocable under **User Settings → Connected
AI apps**.

## Connect from any MCP client [#connect-from-any-mcp-client]

Uptimely's MCP server is a hosted Streamable HTTP endpoint with OAuth 2.1 sign-in. There is nothing to install or run: point the client at the URL below and sign in to Uptimely when the browser opens. Every client that supports remote MCP servers with OAuth works; the ones below are the common ones.

```
https://app.getuptimely.com/api/mcp
```

### Claude (claude.ai, Claude Desktop, Claude Code) [#claude-claudeai-claude-desktop-claude-code]

* **claude.ai / Claude Desktop — fastest:** [Uptimely's listing in Claude's connector directory](https://claude.ai/directory/uptimely); choose *Connect*, then sign in. The connector syncs to Claude Desktop and mobile. Manual: Customize → Connectors → *Add custom connector*, name it Uptimely and paste the URL.
* **Claude Code:** `claude mcp add --transport http uptimely https://app.getuptimely.com/api/mcp` then `/mcp` to sign in.

### ChatGPT and Codex [#chatgpt-and-codex]

* **ChatGPT — fastest:** [open Uptimely's ChatGPT app](https://chatgpt.com/plugins/plugin_asdk_app_6a7ae32b93b48191906fd8f304ad45ff), add it and sign in. Manual: Settings → Apps & Connectors → *Create* (developer mode), name it Uptimely, paste the URL, authentication *OAuth*.
* **Codex CLI:** add to `~/.codex/config.toml`:

```toml
[mcp_servers.uptimely]
url = "https://app.getuptimely.com/api/mcp"
```

### Cursor [#cursor]

One click: [Add to Cursor](https://cursor.com/install-mcp?name=uptimely\&config=eyJ1cmwiOiJodHRwczovL2FwcC5nZXR1cHRpbWVseS5jb20vYXBpL21jcCJ9). Or in `.cursor/mcp.json`:

```json
{
  "mcpServers": { "uptimely": { "url": "https://app.getuptimely.com/api/mcp" } }
}
```

### VS Code and GitHub Copilot [#vs-code-and-github-copilot]

One click: [Add to VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=uptimely\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.getuptimely.com%2Fapi%2Fmcp%22%7D). Or run *MCP: Add Server* → *HTTP* and paste the URL, which writes to `.vscode/mcp.json`:

```json
{
  "servers": {
    "uptimely": { "type": "http", "url": "https://app.getuptimely.com/api/mcp" }
  }
}
```

### Google Antigravity [#google-antigravity]

Install the plugin from the repository (or from the Antigravity Marketplace once listed):

```bash
agy plugin install https://github.com/DevinoSolutions/mcp-servers/antigravity-plugins/uptimely
```

Or add the server by hand in `~/.gemini/config/mcp_config.json` (Antigravity requires the `serverUrl` key):

```json
{
  "mcpServers": {
    "uptimely": { "serverUrl": "https://app.getuptimely.com/api/mcp" }
  }
}
```

### Gemini [#gemini]

* **Gemini app:** Settings → Connected apps → *Custom apps* → *Add a custom app*, paste the URL, then mention `@Uptimely` in a chat. (Custom apps are currently limited to personal Google accounts in the US.)
* **Gemini CLI:** `gemini extensions install https://github.com/DevinoSolutions/mcp-servers` then `/mcp auth uptimely`, or add `{ "mcpServers": { "uptimely": { "httpUrl": "https://app.getuptimely.com/api/mcp" } } }` to `~/.gemini/settings.json`.

### Kiro [#kiro]

One click: [Add to Kiro](https://kiro.dev/launch/mcp/add?name=uptimely\&config=%7B%22url%22%3A%22https%3A%2F%2Fapp.getuptimely.com%2Fapi%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D). Or in `.kiro/settings/mcp.json`:

```json
{
  "mcpServers": { "uptimely": { "url": "https://app.getuptimely.com/api/mcp" } }
}
```

### Perplexity, Mistral Le Chat, Grok [#perplexity-mistral-le-chat-grok]

* **Perplexity** (Pro, Max, Enterprise): Settings → Connectors → *Custom connector*, paste the URL, authentication *OAuth*.
* **Mistral Le Chat** (all plans): Intelligence → Connectors → *Add Connector* → *Custom MCP Connector*, paste the URL.
* **Grok:** grok.com → Connectors → *New connector* → *Custom*, paste the URL.

### Other clients [#other-clients]

* **Replit:** [Add to Replit](https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6IlVwdGltZWx5IiwiYmFzZVVybCI6Imh0dHBzOi8vYXBwLmdldHVwdGltZWx5LmNvbS9hcGkvbWNwIn0%3D), or Integrations → *Add MCP server*.
* **Devin, Windsurf, Zed, JetBrains Junie, Cline, OpenCode:** add a remote (HTTP) MCP server with the URL above; each prompts for the OAuth sign-in on first use. Cline can also install it from the [Cline marketplace entry](https://github.com/DevinoSolutions/mcp-servers/tree/main/uptimely) using its `llms-install.md`.

Tokens are scoped to what you approve on the consent screen; a tool you did not grant is never shown to the assistant. Revoke access at any time under **User Settings → Connected AI apps**.

## Write access follows the permissions you approve [#write-access-follows-the-permissions-you-approve]

Read and write tools are both offered; the consent screen has one checkbox row
per permission group, all checked by default, and a tool you did not grant is
never shown to the assistant. Deleting things asks for a one-time confirmation
code the assistant passes back on a second call. Steps that need a browser, such as card entry or connecting Slack, come back as a one-click link. The /v1 write surface
additionally requires the Pro plan, and the copilot asks you to approve each
write in the chat.

## In-app copilot [#in-app-copilot]

The dashboard ships an AI copilot (⌘I, or the launcher in the corner): ask
it about your monitors and incidents, or let it do the clicking for you —
every write it proposes requires your explicit in-chat approval before it
runs.

## API keys and agents [#api-keys-and-agents]

Project API keys (`uptimely_live_…`) also authenticate machine access — see
[API](/api). OAuth-minted agent tokens and API keys are deliberately
separate credential types: /v1 accepts project API keys, the MCP surface
accepts OAuth tokens.
