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).

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

Related MCP server: DevHelm MCP Server

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"
      }
    }
  }
}

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

Commands

Tools

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

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.