Install

npm install -g https://app.monitoraweb.com/mcp/monitoraweb-mcp.tgz

Or nothing at all: the configuration below runs it with npx.

Configure

The token is in the panel, under Account → API. Paste this into claude_desktop_config.json (Claude Desktop) or .mcp.json (Claude Code):

{
  "mcpServers": {
    "monitoraweb": {
      "command": "npx",
      "args": ["-y", "https://app.monitoraweb.com/mcp/monitoraweb-mcp.tgz"],
      "env": {
        "MONITORAWEB_TOKEN": "your-token"
      }
    }
  }
}

Variable	What it is for	Default
MONITORAWEB_TOKEN	Your API token. Required.	—
MONITORAWEB_API	API base URL.	https://api.monitoraweb.com/v1
MONITORAWEB_READONLY	Set to 1 and only the read tools exist: the assistant cannot change anything.	off

Tools

Tool	What it does	Type
list_monitors	Lists the monitors with their current status; searches by name or URL.	read
get_monitor	One monitor by id, with everything it knows about it.	read
list_incidents	Incidents of the account, or of one monitor.	read
get_monitor_stats	Daily series: checks, average response time, incidents or minutes down.	read
domain_lookup	WHOIS/RDAP of a domain: registrar, expiry, name servers, transfer lock.	read
create_monitor	Creates a monitor: a URL over HTTP, a DNS record, a UDP service, a TCP port, a ping or an API.	write
pause_monitor	Pauses a monitor: no checks, no alerts.	write
resume_monitor	Resumes a paused monitor.	write

Ask it things like

• Which of my clients are down right now?
• How many domains expire in less than 30 days?
• Pause the shop monitor while we do the maintenance.
• Which monitor was slowest last week?

Security

• The token stays on your computer, in the client configuration. We never see it leave your machine except as a normal API call.
• The server adds no endpoint: it is a thin client over the documented API v1.
• With MONITORAWEB_READONLY=1 the assistant can read but not create, pause or change anything.
• If a token leaks, change it in Account → API: the old one stops working immediately.

Back to the API documentation