Tallwatch MCP

Public install wrapper for the Tallwatch MCP server. The server is hosted at https://api.tallwatch.com/mcp. There is no npm package and no local npx process.

Check org status, list monitors, triage incidents, see who is on call, and (with a write key) pause monitors or ack/resolve incidents. Same ops surface as the CLI. Guide: docs.tallwatch.com/integrations/mcp.

This repo holds the Cursor plugin files. The server code lives in the Tallwatch API (packages/mcp).

Install

Create a key in Settings → API keys. The tw_live_… secret is shown once. Copy prompt on that page pastes client-specific setup into the agent.
Merge the block for this client. Prefer user-level config so the key is not git-tracked. The URL field name is not the same in every client; the wrong key is ignored or falls back to SSE.

Cursor (~/.cursor/mcp.json). Remote entries use url and headers. Do not set type.

{
  "mcpServers": {
    "tallwatch": {
      "url": "https://api.tallwatch.com/mcp",
      "headers": {
        "Authorization": "Bearer tw_live_your_key_here"
      }
    }
  }
}

You can put the secret in the environment instead: "Authorization": "Bearer ${env:TALLWATCH_API_KEY}". Reload MCP in Cursor Settings.

Client	Config
Cursor	`~/.cursor/mcp.json` (user) or `.cursor/mcp.json` (project). `url` + `headers`. No `type`.
VS Code	Command Palette → MCP: Open User Configuration, or `.vscode/mcp.json`. Key is `servers`, not `mcpServers`. `"type": "http"` is required.
Claude Code	`claude mcp add --scope user --transport http --header "Authorization: Bearer tw_live_your_key_here" tallwatch https://api.tallwatch.com/mcp`
Claude Desktop	`claude_desktop_config.json` is stdio-only. Bridge with `mcp-remote`. Connectors are OAuth-only and will not send this Bearer key.
Codex	`~/.codex/config.toml`. `url` plus `bearer_token_env_var = "TALLWATCH_API_KEY"` (the env var name, not the token).
Devin Desktop	`~/.codeium/windsurf/mcp_config.json`. URL field is `serverUrl`.
Devin CLI	`~/.config/devin/mcp_config.json` or `.devin/mcp_config.local.json`. Uses `url`.
Gemini CLI	`httpUrl`, not `url` (`url` is SSE). `gemini mcp add --scope user --transport http --header "Authorization: Bearer tw_live_your_key_here" tallwatch https://api.tallwatch.com/mcp`
Cline	`~/.cline/mcp.json`. `"type": "streamableHttp"` is required.
Continue	`config.yaml` or `.continue/mcpServers/`. `type: streamable-http`. Headers under `requestOptions`.

VS Code:

{
  "servers": {
    "tallwatch": {
      "type": "http",
      "url": "https://api.tallwatch.com/mcp",
      "headers": {
        "Authorization": "Bearer tw_live_your_key_here"
      }
    }
  }
}

Codex:

[mcp_servers.tallwatch]
url = "https://api.tallwatch.com/mcp"
bearer_token_env_var = "TALLWATCH_API_KEY"

Full snippets: docs.tallwatch.com/integrations/mcp.

Tools

Prefer get_status when asking what is broken. Same capability set as the CLI (minus browser login / browse / import).

Scope	Tools
`read`	`get_status`, `whoami`, `list_monitors`, `get_monitor`, `list_incidents`, `get_incident`, `list_oncall_now`, `list_status_pages`, `get_status_page`
`write`	`create_monitor`, `update_monitor`, `pause_monitor`, `resume_monitor`, `trigger_test_check`, `acknowledge_incident`, `resolve_incident`, `add_postmortem`