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