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
Demo status page	https://stillonline.tech/s/demo

Quick setup

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

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:

1. Confirm the package from npm
2. Arrow keys + Enter — Cursor, Antigravity, Codex, Claude Code, Windsurf, or Other agent
3. Cursor / Antigravity / Windsurf — writes MCP JSON config
4. Codex / Claude Code — codex mcp add / claude mcp add + snippet
5. 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:

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

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

Options

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

{
  "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
list_projects	GET /projects
create_project	POST /projects	name, url; optional description
delete_project	DELETE /projects/{id}	Soft-delete
list_checks	GET /projects/{id}/checks
create_check	POST /projects/{id}/checks	url; optional name, interval_seconds
update_check	PATCH /checks/{id}	Pause: enabled: false
delete_check	DELETE /checks/{id}
get_public_status	GET /public/status/{slug}	No API key
create_incident	POST /status-pages/{id}/incidents	title
list_incidents	GET /incidents/{id}

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

Development

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 and PulseMCP after registry ingest.

License

MIT — see LICENSE.