Pull your own MonitorFree data — servers, metrics, alerts — into Grafana, a script, or anything else you run, using a read-only API key. No separate signup, no extra product; you already have this.
From your dashboard, go to Settings → API Keys and create one. The key is shown once at creation time — copy it somewhere safe, MonitorFree never displays it again (only the first few characters, for identification, once you leave the page). Keys are read-only: they can pull data about your account, but can't change settings, add servers, or acknowledge alerts.
Every API key starts with mfk_. Send it as a Bearer
token in the Authorization header on every request:
curl https://api.monitorfree.com/servers \
-H "Authorization: Bearer mfk_your_key_here"
A missing or invalid key returns 401. A revoked key
stops working immediately — revoking is instant, not just hidden
from the UI.
All endpoints are read-only GET requests and return JSON.
| Endpoint | Returns |
|---|---|
GET/servers | All servers on your account |
GET/servers/usage | Plan/usage summary (servers used vs. limit) |
GET/servers/{id} | Detail for one server |
GET/servers/{id}/metrics?range=24h | Time-series CPU/mem/disk/network history (range: 1h, 6h, 24h, 7d — clamped to your plan's retention) |
GET/servers/{id}/uptime | Uptime history |
GET/servers/{id}/processes | Top processes snapshot |
GET/servers/{id}/disk-partitions | Per-partition disk usage |
GET/servers/{id}/docker-containers | Running containers, if Docker is detected |
GET/servers/{id}/network-interfaces | Network interface stats |
GET/servers/{id}/listening-ports | Open/listening ports |
GET/servers/{id}/export?format=csv&range=7d | Raw metrics export (format: csv or json) |
GET/servers/{id}/audit-log | Server activity log (logins, config changes, sessions) |
| Endpoint | Returns |
|---|---|
GET/alerts/{server_id}/rules | Alert rules configured on a server |
GET/alerts/{server_id}/events | Alert firing history for a server |
GET/alerts/events/{event_id}/timeline | Detail timeline for a single alert event |
curl "https://api.monitorfree.com/servers/<server_id>/metrics?range=24h" \
-H "Authorization: Bearer mfk_your_key_here"Returns an array of samples (timestamp, CPU%, memory, disk, network, load average) — enough to feed a Grafana JSON/infinity datasource, a cron script, or your own alerting on top of ours.
There's no separate per-key rate limit today — requests are subject to the same general per-IP limits as the rest of the API. In practice this means: don't poll faster than once every few seconds per endpoint. If you're building something that needs tighter limits raised, contact us.