Documentation

StillOnline MCP for AI Agents

Connect StillOnline to agent IDEs and CLIs via stillonline-mcp on your machine — interactive setup, nothing to deploy on a server.

Install

After this guide you will install stillonline-mcp in your IDE, create a Pro/Ultimate API key, and read uptime and incidents from your agent.

MCP (Model Context Protocol) lets AI IDEs call external tools. StillOnline exposes uptime and incidents via the stillonline-mcp npm package. modelcontextprotocol.io · npm

Nothing on a server. On your machine, run the setup wizard — it writes your key to mcp.json (hidden input, never into AI chat).

One command (wizard auto-starts)

In a terminal (not AI chat), npx opens setup. Cursor, Antigravity, Windsurf: auto-write; Codex, Claude Code: CLI command + config snippet. Use --ru for Russian CLI.

terminal

npx -y stillonline-mcp

Explicit alias: npx -y stillonline-mcp setup

stillonline-mcp on npmjs.com

StillOnline MCP on Smithery

Explicit wizard with Russian CLI: npx -y stillonline-mcp setup --ru

Setup

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

API key

Create a key (Pro/Ultimate), copy sk_live_… — shown once.

Wizard or JSON

Preferred: npx -y stillonline-mcp setup. Or paste JSON into MCP settings:

JSON

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

PowerShell (paste key)

If Ctrl+V fails in hidden input — visible mode (key on screen; do not share your display):

terminal

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

Restart MCP

After setup: Settings → MCP → Refresh (or restart the window). Tools should appear: projects.list, checks.create, … (~10 tools).

Verify

Without a key in logs: STILLONLINE_API_KEY is required
Ask the agent to call projects.list

Tools (npm 0.3.6+)

Covers main REST v1 write operations. Limits: 120 GET and 30 write requests per minute per key — see REST API. Legacy underscore names are accepted as aliases, but dot-notation is the new canonical naming.

Tool	Purpose
projects.list	List projects
projects.create	Create project (name, url)
projects.delete	Delete project (soft)
checks.list	Project checks
checks.create	Add URL check
checks.update	Pause (enabled), name, interval
checks.delete	Delete check
status.get	Public JSON by slug
incidents.create	Open incident
incidents.get	Incident by id

Supported MCP clients

Agent	Where	Config
Cursor	Settings → MCP	~/.cursor/mcp.json
Google Antigravity	MCP Servers → Manage → View raw config	~/.gemini/antigravity/mcp_config.json
OpenAI Codex CLI	codex mcp add … or ~/.codex/config.toml	[mcp_servers.stillonline]
Claude Code	claude mcp add …	~/.claude.json
Windsurf	Cascade → MCP	~/.codeium/windsurf/mcp_config.json

Wizard: npx -y stillonline-mcp — auto-writes for Cursor, Antigravity, Windsurf; Codex & Claude Code show CLI + config.