stillonline-mcp

MCP server for StillOnline — hosted uptime monitoring and status pages for indie SaaS and production AI agents.

Use it from Cursor, Claude Code, Windsurf, Codex, Antigravity, or any MCP-compatible client. Wraps StillOnline REST API v1 (Pro/Ultimate).


Product	https://stillonline.tech
MCP docs	https://stillonline.tech/docs/mcp
npm	https://www.npmjs.com/package/stillonline-mcp
Official MCP Registry	`io.github.shenwell/stillonline`
Smithery	https://smithery.ai/servers/frenkyjuss/stillonline
Demo status page	https://stillonline.tech/s/demo

Quick setup

Run in PowerShell or Terminal (not in the AI chat):

Terminal

npx -y stillonline-mcp

Same as npx -y stillonline-mcp setup — the wizard starts when you run the package in a terminal. Editors launch the MCP server over stdio separately.

The wizard will:

Confirm the package from npm
Arrow keys + Enter — Cursor, Antigravity, Codex, Claude Code, Windsurf, or Other agent
Cursor / Antigravity / Windsurf — writes MCP JSON config
Codex / Claude Code — codex mcp add / claude mcp add + snippet
Verify the API key against StillOnline

Empty or invalid key → error and prompt again.

PowerShell paste: hidden input often blocks Ctrl+V — use right-click, Shift+Insert, or:

Terminal

npx -y stillonline-mcp setup --visible-key --ru

Then reload MCP in your editor (e.g. Cursor Settings → MCP → Refresh).

Options

Terminal

npx -y stillonline-mcp setup --client cursor --ru
npx -y stillonline-mcp setup --dry-run
npx -y stillonline-mcp setup --yes    # overwrite existing stillonline block

Requirements

StillOnline account with Pro or Ultimate
API key from Settings → API (sk_live_…, shown once)

Security

Do not paste your API key into the AI chat. Use setup or MCP env on your machine only.

Manual MCP config

config.json

{
  "mcpServers": {
    "stillonline": {
      "command": "npx",
      "args": ["-y", "stillonline-mcp"],
      "env": {
        "STILLONLINE_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

Client	Config file (examples)
Cursor	`~/.cursor/mcp.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claude_desktop_config.json`

Optional env: STILLONLINE_API_BASE (default https://api.stillonline.tech/v1).

Commands

Command	Purpose
`npx -y stillonline-mcp`	MCP server (stdio, for editors)
`npx -y stillonline-mcp setup`	Interactive installer
`npx -y stillonline-mcp --help`	CLI help

Tools

Tool	REST	Notes
`projects.list`	`GET /projects`
`projects.create`	`POST /projects`	`name`, `url`; optional `description`
`projects.delete`	`DELETE /projects/{id}`	Soft-delete
`checks.list`	`GET /projects/{id}/checks`
`checks.create`	`POST /projects/{id}/checks`	`url`; optional `name`, `interval_seconds`
`checks.update`	`PATCH /checks/{id}`	Pause: `enabled: false`
`checks.delete`	`DELETE /checks/{id}`
`status.get`	`GET /public/status/{slug}`	No API key
`incidents.create`	`POST /status-pages/{id}/incidents`	`title`
`incidents.get`	`GET /incidents/{id}`

Legacy underscore names such as list_projects and create_check are accepted as call aliases, but new clients should use the dot-notation names above.

Rate limits: 120 GET / 30 write per minute per key. On 429, errors include RATE_LIMIT and retry_after.

Development

bash

git clone https://github.com/shenwell/stillonline-mcp.git
cd stillonline-mcp
npm install
npm run build
npx stillonline-mcp setup --dry-run

For local MCP server mode, point your client at node + absolute path to dist/cli.js with env.STILLONLINE_API_KEY.

Maintainers syncing from the private StillOnline monorepo: see PUBLISH.md.

Official MCP Registry

This package is published to the Official MCP Registry as io.github.shenwell/stillonline (npm stdio transport). Listed on aggregators such as MCP.so, Smithery, and PulseMCP after registry ingest.

License

MIT — see LICENSE.