<!-- Windsurf setup — Uptimely -->
> Markdown version of https://getuptimely.com/agent-setup/windsurf — the page itself is the canonical copy.

AI agents

# Connect Uptimely to Windsurf

Onboard your AI agent to Uptimely+7

Configure

## Register the MCP server

Add this to `~/.codeium/windsurf/mcp_config.json`, merging with any existing entry rather than replacing it:

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

Copy the config entry

Sign in

## Authorize the connection

Open the Cascade panel, choose MCPs, and refresh. Windsurf asks you to sign in when the server first answers 401.

Verify

## Confirm it worked

Ask Windsurf to call `search_tools`, then `execute_typescript` with `return await external_uptimely_project_list({});`. A client that lists `uptimely_project_list` as its own tool can call it directly. A JSON list of your projects — even an empty list — means the connection is live.

If you also configured the SDK or REST API, this should answer HTTP 200 with a JSON body whose `data` is a list of monitors:

```
curl -sS -H "Authorization: Bearer $UPTIMELY_API_KEY" https://app.getuptimely.com/v1/monitors
```

Copy the check

Reference

## More

Read on Windsurf's own docs (checked 2026-09-22): <https://docs.windsurf.com/plugins/cascade/mcp>

Or fetch the raw, machine-readable instructions this page is rendered from: [https://getuptimely.com/agent-setup/prompt.md](https://getuptimely.com/agent-setup/prompt.md)