MCP Server
hookpulse
net.hookpulse/hookpulse
What this MCP does
Creates and manages dead-man monitoring endpoints for cron jobs and webhooks, detects missed or failed runs, and provides event, alert, and public status feeds.
Capabilities
Tools
41
tools
api_index
API index
Full index of the HookPulse API.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
billing
Billing
Free plan, x402 prices and the trial offer: an account = 90 days without the usage paywall, counted from its first use here (`trial` field; with a session it shows the state). Check before creating the second monitor or lowering the interval: it is the number IN FORCE, not the documentation's.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
contact
Contact
Write to the people behind the product: a question, or a sponsorship/partnership/advertising proposal. Free, no captcha and no payment; one message every 10 s per network (one that arrives sooner waits its turn). One route for a question and for a sponsorship, partnership or ad proposal (`tipo`, with the placements of `GET /api/partners`). No captcha, no account, no payment. One message every 10 seconds per network: one that arrives sooner waits its turn and then goes out — no error. The message reaches the team by e-mail, with `email` as the reply address.
Input schema
{'type': 'object', 'required': ['name', 'email', 'message'], 'properties': {'name': {'type': 'string', 'description': 'What to call the person writing.'}, 'site': {'type': 'string', 'description': 'Website of who is proposing.'}, 'tipo': {'enum': ['patrocinio', 'parceria', 'anuncio'], 'type': 'string', 'description': 'Proposal: `patrocinio`, `parceria` or `anuncio`. Turns on the fields below.'}, 'email': {'type': 'string', 'description': 'Where to reply.'}, 'espaco': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Placement ids from `GET /api/partners`, up to 6.'}, 'duracao': {'enum': ['30', '90', '365'], 'type': 'string', 'description': 'Exposure in days: `30`, `90` or `365`.'}, 'empresa': {'type': 'string', 'description': 'Who is proposing, when it is a company.'}, 'message': {'type': 'string', 'description': 'What you want to say.'}, 'orcamento': {'enum': ['ate_100', '100_500', '500_2000', '2000_mais', 'a_combinar'], 'type': 'string', 'description': '`ate_100`, `100_500`, `500_2000`, `2000_mais` or `a_combinar`.'}, 'pagamento': {'enum': ['usdc', 'deposito', 'a_combinar'], 'type': 'string', 'description': '`usdc`, `deposito` or `a_combinar`.'}}}
create_collection
Create collection
Adds compatible measurements to a previously detected device. First create /api/ambientes and submit its environment report. Reference that ambiente_id here; its saved name and group are authoritative. Same device+measurement returns the existing stream instead of duplicating it. A profile adds only compatible measurements. Up to 200 collections per owner. The signed collection id writes only its own measurement stream.
Input schema
{'type': 'object', 'required': ['nome', 'ambiente_id'], 'properties': {'nome': {'type': 'string', 'description': 'Device name, up to 60 characters.'}, 'grupo': {'type': 'string', 'description': 'Optional group, up to 40 characters.'}, 'medida': {'type': 'string', 'description': 'Which measurement; defaults to `loadavg`.'}, 'perfil': {'enum': ['essentials', 'completo'], 'type': 'string', 'description': 'essentials or completo. Expands to compatible measurements and takes precedence over medida.'}, 'ambiente_id': {'type': 'string', 'description': 'UUID of a detected environment owned by this account/guest.'}}}
create_device_input
Create device input
Create or rotate an authenticated collector channel for this device. Ownership is checked before the app asks the input central. The server chooses the channel id and authenticates batches only against a hash of the collector credential. The whole setup this call returns — credential included — is also saved, encrypted with a key only the input central holds and bound to that credential, so the owner can read it again with GET /api/ambientes/:id/inputs/:collector/setup. The credential does not expire: a device that stays off for weeks reconnects with it. It stops working only when a new configuration rotates it or the channel is removed. A repeated call for the same collector rotates the credential, replaces the saved setup and replaces `monitoring` with the list sent — that is how the monitored scope is edited — so the configuration on the device stops authenticating until it is replaced; a paused channel stays paused. DNS selects the receiver; it never authenticates the device.
Input schema
{'type': 'object', 'required': ['id', 'collector', 'monitoring'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'collector': {'enum': ['alloy', 'telegraf', 'opentelemetry', 'ncpa', 'collectd', 'snmp'], 'type': 'string', 'description': 'alloy, telegraf, opentelemetry, ncpa, collectd or snmp.'}, 'monitoring': {'type': 'array', 'items': {'enum': ['system', 'host', 'disk', 'network', 'mysql', 'asterisk'], 'type': 'string'}, 'maxItems': 5, 'minItems': 1, 'description': 'One or more of system (the whole machine), host (CPU, memory, load and uptime), disk, network, mysql and asterisk. `system` already includes host, disk and network, and those three together are stored as `system`. Items the collector cannot collect (see `collects` on the channel) are not measured.', 'uniqueItems': True}}}
create_endpoint
Create endpoint
Creates a dead-man endpoint. Use cron+tz+grace_sec for a real schedule (mutually exclusive with interval_sec) or interval_sec for plain silence detection. max_duration_sec alerts when a run opened by /in/:id/start hangs. May return 402 x402 when it leaves the free tier. This response is the only one that shows the monitor's `token` and the `templates` — keep them. The second monitor, or an interval below the free minimum, answers **402 with `accepts[]`**: pay and repeat. A miss alerts at most once per 24h — or per `alert_repeat_sec`, or per interval, whichever is longer. Send `cron`+`tz`+`grace_sec` instead of `interval_sec` for a real schedule: a 03:00 backup is late at 03:01:30, not 24 hours later. `max_duration_sec` catches the other failure: a run that starts and hangs, which plain silence detection only notices at the next scheduled time.
Input schema
{'type': 'object', 'required': ['guest_token', 'name'], 'properties': {'tz': {'type': 'string', 'description': 'IANA time zone for cron, default UTC'}, 'cron': {'type': 'string', 'description': 'five-field cron, e.g. 0 3 * * *'}, 'name': {'type': 'string', 'description': 'how you will recognise the routine in an alert; required, trimmed, max 80 chars, punctuation alone is rejected'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'up to 8 tags to group the monitor; lower-cased, [a-z0-9._-], max 32 chars each'}, 'alert_to': {'type': 'string', 'description': 'E-mail to alert on a miss; without it, the account is alerted.'}, 'alert_url': {'type': 'string', 'description': 'Public HTTPS URL that receives a POST on a miss (Slack Incoming, Discord, n8n).'}, 'grace_sec': {'type': 'number', 'description': 'tolerance after the scheduled time, default 90, min 30'}, 'guest_token': {'type': 'string'}, 'interval_sec': {'type': 'number', 'description': 'Tolerated silence, in seconds. Below the free minimum, it costs.'}, 'paused_until': {'type': 'string', 'description': 'maintenance window end (UTC ISO), max 30 days ahead'}, 'alert_repeat_sec': {'type': 'number', 'description': 'gap before the same incident alerts again, 3600..2592000; null keeps the 86400 default'}, 'max_duration_sec': {'type': 'number', 'description': 'ceiling for an open run in seconds, 60..86400; null or 0 turns it off'}}}
create_environment
Create environment
Register a device UUID before discovery and collector selection. Registers one device (maximum 25 per owner), creating a guest if needed. The UUID is the one-hour discovery capability; it is not a telemetry credential. Choose passos.posix or passos.powershell for the TARGET terminal. The checks only display allowlisted system facts and install nothing.
Input schema
{'type': 'object', 'required': ['nome'], 'properties': {'nome': {'type': 'string', 'description': 'Device name, 1–60 characters.'}, 'grupo': {'type': 'string', 'description': 'Optional group, up to 40 characters.'}, 'request_id': {'type': 'string', 'format': 'uuid', 'description': 'Optional UUID v4 generated once per registration. Becomes the device id. Retry with the same id/name/group returns the owned environment instead of duplicating a late write; conflicting input is refused.'}}}
create_guest
Create guest
Creates a guest token hp_… Keep the token: without it there is no way back to the monitors, unless you have already tied them to an e-mail.
Input schema
{'type': 'object', 'properties': {}}
delete_collection
Delete collection
Removes one measurement and frees that slot on the device. What disappears is the OWNERSHIP: your list, the authority to read that series, and the unique slot that measurement holds on that environment — so you can add it again later. Readings already stored at the ingest origin stay there until their own retention. The machine keeps sending: the symbol is signed and stands on its own there, which is why the answer carries `remover`, the command that takes the line out of the crontab. Use `ativa:false` instead when you only want to stop looking.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'The signed 22-character collection symbol, or a legacy UUID v4.'}}}
delete_device_input
Delete device input
Revokes and removes one collector channel from a device. The input central removes only a channel of the same owner. This stops new authenticated input and removes the channel from the device list — also for a channel whose device was already deleted. It does not uninstall or stop the collector on the device (`uninstall.remove` in GET /api/ambientes/:id/inputs is the command for that), and stored measurements remain subject to their retention policy.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['id', 'collector'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'collector': {'enum': ['alloy', 'telegraf', 'opentelemetry', 'ncpa', 'collectd', 'snmp'], 'type': 'string', 'description': 'alloy, telegraf, opentelemetry, ncpa, collectd or snmp.'}}}
delete_endpoint
Delete endpoint
Removes the owner's endpoint.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['guest_token', 'id'], 'properties': {'id': {'type': 'string', 'description': 'ID of the monitor to deactivate.'}, 'guest_token': {'type': 'string'}}}
delete_environment
Delete environment
Removes a device and every measurement on it, in one call. One call, not one per measurement — the same reason `GET /api/coletas/serie` exists. What goes away is the ownership: your list, the authority to read those series, and the slots those measurements held, so the device can be registered again. Readings already stored at the ingest origin stay there until their own retention, and the machine keeps sending: the symbols are signed and stand on their own there. That is why the answer carries `remover`, one command per measurement that had a cron line. The device's collector channels are revoked first; if the input central cannot confirm that, nothing is deleted (503) and the call can be repeated, so no channel is left receiving data without a device.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}}}
get_collection_series
Get collection series
The latest readings of one device, for the screen that draws it. Authorised by YOUR session, never by the symbol in the crontab. A device that is not yours answers 404 exactly like one that does not exist — telling the two apart would confirm to a stranger that the id exists — 401 is only for sending no credential at all, which tells the caller what they already know. When the ingest origin cannot be read the answer is 503, not an empty series: a screen must say "I could not read now", never let you believe your machine stopped. Readings are reused for up to 60 seconds. Poll no faster than once per minute in steady use; `poll_after_sec` is the minimum wait for this response. During the first minute after registration an empty series may be checked every 5 seconds. Do not overlap requests. On 429 or 503, respect `Retry-After` and `retry_after_sec`, increase the delay after repeated failures, and keep the last successful reading. Changing n does not bypass reuse or capacity limits.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'n': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'How many readings, newest first. Default 60, maximum 500.'}, 'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'The signed 22-character collection symbol, or a legacy UUID v4.'}}}
get_device_input_batch
Get device input batch
One received batch, decoded: its series with labels and values, or its NCPA checks. Remote Write (1.0 and 2.0), OTLP (protobuf or JSON) and NRDP become the same shape: `series` (`name`, `labels`, `points` as `[milliseconds, value]`, and `type`/`unit`/`help` when the collector sent them; OTLP points also carry `resource`, an index into `resources`) or `checks` for NCPA (`host`, `service`, `state` 0–3, `output`, `perfdata`). A value JSON cannot hold comes as a string: `"NaN"`, `"+Inf"`, `"-Inf"` or `"stale"`. Very large batches keep the first 5,000 series (`truncated`). `newer`/`older` are the neighbouring batch ids, for moving through the history.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id', 'collector', 'batch'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'batch': {'enum': ['1790165043059-0005-s-204-w-5357'], 'type': 'string', 'description': 'The batch `id` from the history list.'}, 'collector': {'enum': ['alloy', 'telegraf', 'opentelemetry', 'ncpa', 'collectd', 'snmp'], 'type': 'string', 'description': 'alloy, telegraf, opentelemetry, ncpa, collectd or snmp.'}}}
get_device_input_setup
Get device input setup
The saved setup of one collector channel: the configuration in use, its files and steps. Returns the setup generated last for this channel — the one whose credential is accepted now — exactly as POST /api/ambientes/:id/inputs returned it, so the files can be copied or installed again without rotating the credential. It carries the credential: only the device owner gets it, one channel per request, never cached; list routes never include it. 404 `setup_not_saved` when the channel was generated before setups were saved, or was removed; 409 `setup_unreadable` when the input central can no longer open it. In both cases generate a new setup with POST /api/ambientes/:id/inputs.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id', 'collector'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'collector': {'enum': ['alloy', 'telegraf', 'opentelemetry', 'ncpa', 'collectd', 'snmp'], 'type': 'string', 'description': 'alloy, telegraf, opentelemetry, ncpa, collectd or snmp.'}}}
get_endpoint
Get endpoint
Status of one endpoint (use the endpoint token if you have it). The monitor token only reads: it lets you put the state on a third-party dashboard without handing over the owner's credential. With a schedule it is here that `next_expected_at` says when the next run is due. Only this endpoint carries `duration`: `p50_ms` (the low median, so always a duration that really happened) and `max_ms` over the last runs we measured, computed at read time over the event window we already keep — the list does not pay for it.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Monitor ID, from `Monitor.id`.'}, 'token': {'type': 'string', 'description': 'endpoint token (query)'}, 'guest_token': {'type': 'string'}}}
get_environment
Get environment
Read the detected environment and compatible measurements.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}}}
health
Health
Liveness.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
import_crontab
Import crontab
Reads a crontab and proposes one monitor per scheduled line. Without apply=1 nothing is written; the proposal says what was ignored and why. Passwords in the command are redacted. The body is the crontab itself, as `text/plain`. Without `?apply=1` **nothing is written**: you get the proposal — what would become a monitor, what was ignored and why, and what still fits in the free tier. With `apply=1` it is all or nothing, under the same rules as `POST /api/endpoints`. Comments, variables and `@reboot` are ignored (there is no way to know when to expect a reboot); `@daily` and friends become the equivalent expression. The command becomes the monitor name, with passwords and tokens redacted first — the name travels in the alert e-mail, in the public dashboard and in the badge.
Input schema
{'type': 'object', 'required': ['guest_token', 'crontab'], 'properties': {'apply': {'type': 'string', 'description': '"1" to create the monitors'}, 'crontab': {'type': 'string', 'description': 'the crontab text'}, 'guest_token': {'type': 'string'}}}
ingest_key
Ingest key
Returns (minting the first time) the key for /in/<key>/<slug>, where a ping creates its own monitor inside the free tier. Instruments a whole fleet with no setup call per job. One key per owner. Point a whole fleet at `/in/<key>/<slug>` and each job creates its monitor on the first check-in, **inside the free tier** — beyond it the ping answers 402 without creating anything. The key survives signing in: the crontab you deployed keeps working.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'guest_token': {'type': 'string'}}}
ingest_key_rotate
Ingest key rotate
Rotates the ingest key; the previous one stops creating monitors. Existing ones keep working. Monitors already created keep working — rotating only revokes the power to create new ones.
Destructive
Idempotent
Input schema
{'type': 'object', 'properties': {'guest_token': {'type': 'string'}}}
list_collections
List collections
Lists your measurements with commands adapted to each saved device environment. Two views of the same thing: `coletas` is one entry per measurement, `equipamentos` is one per machine with a SINGLE command that does all of its measurements and a SINGLE cron line. Use the device one unless you really want a single measurement on its own. Commands are generated only from a detected environment. Legacy collections without one keep their readings, but comandos.agora/agenda are null until a compatible environment is provided. Curl, wget and Python 3 follow the detected capabilities; Windows disk uses PowerShell. comandos.agora is a readable multiline block; run the whole block together. A separate cron line is offered only when crontab exists. Unsupported formats are never guessed.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
list_device_input_history
List device input history
The batches this collector sent, newest first — filtered and paginated on the server. Every batch the input central received for this channel, as it arrived: when, the protocol, the result (`stored`; `rejected` by the receiver, with the reason; or `discarded` while the channel was paused, when its data is not kept), the answer given to the collector, the size, and how many series and samples it carried. The central keeps the newest batches of each channel up to the limits in `limits` (count, bytes and days); older ones leave as new ones arrive, and removing the channel deletes them. `q` searches metric names — host and service names for NCPA — by opening the batches newest first within a time budget: `search.complete` says whether all candidates were read, and repeating the call continues faster. Open one batch with GET /api/ambientes/:id/inputs/:collector/history/:batch.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id', 'collector'], 'properties': {'q': {'type': 'string', 'maxLength': 120, 'description': 'Metric name (or NCPA host/service) contains this text; up to 120 characters.'}, 'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page, from 1 (newest). Beyond the last page answers the last one.'}, 'size': {'enum': [10, 25, 50, 100], 'type': 'integer', 'default': 25, 'description': 'Batches per page: 10, 25, 50 or 100.'}, 'since': {'type': 'string', 'format': 'date-time', 'description': 'Only batches received at or after this instant (ISO 8601).'}, 'until': {'type': 'string', 'format': 'date-time', 'description': 'Only batches received at or before this instant (ISO 8601).'}, 'outcome': {'enum': ['stored', 'rejected', 'discarded'], 'type': 'string', 'description': 'Only batches with this result.'}, 'collector': {'enum': ['alloy', 'telegraf', 'opentelemetry', 'ncpa', 'collectd', 'snmp'], 'type': 'string', 'description': 'alloy, telegraf, opentelemetry, ncpa, collectd or snmp.'}}}
list_device_inputs
List device inputs
List this device's collector channels, their state and their live numbers.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}}}
list_endpoints
List endpoints
Lists the guest's/session's endpoints.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['guest_token'], 'properties': {'guest_token': {'type': 'string'}}}
list_environments
List environments
Saved environments owned by the current account or guest; empty without a session.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
list_events
List events
Latest ingest pings.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'ID of the monitor.'}, 'token': {'type': 'string', 'description': 'Monitor token, alternative to the `X-Hook-Token` header.'}, 'guest_token': {'type': 'string'}}}
list_input_fleet
List input fleet
Every collector channel of the caller, with state and live numbers, in one response. One call for the whole fleet — one query to the time-series store for all channels, never one per device. It is the same function the dashboard subscribes to over the socket (`/api/inputs/serie`), where the input central then pushes `inputs.updated` and `inputs.removed` events; integrators get the same data here without the socket.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
list_templates
List templates
Ingest snippets and the JSON HookPulse POSTs on a miss. It exists so nobody guesses the alert format: `miss_json` and `recovery_json` here are the same bodies that arrive at your `alert_url`. Slack and Discord receive only the field they read.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
ping_ingest
Ping ingest
Simulates the cron: GET on /in/:id. No credential on purpose — the caller is a cron, and the ID is already the secret. It costs nothing and there is no quota per ping.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Monitor ID, from `Monitor.ingest_url`.'}}}
ping_slug
Ping slug
Ping that creates its own monitor on the first hit. Same slug = same monitor; 402 when the free tier is full, and then nothing is written. The slug becomes the monitor name and its identity: the same slug always means the same monitor, so a retry never creates a second one. Normalised to lowercase, `[a-z0-9-]`, 40 chars. Creation happens **only inside the free tier** (or the trial); past it the ping is a 402 with `accepts[]` and nothing is written — not even the event. Works by GET or POST.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['ingestKey', 'slug'], 'properties': {'slug': {'type': 'string', 'description': 'Name of the job; it becomes the monitor name.'}, 'ingestKey': {'enum': ['hpk_exemplo'], 'type': 'string', 'description': 'Ingest key, from `GET /api/ingest-key`.'}}}
pricing
Pricing
Current public prices and free allowances; no charge.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
report_environment
Report environment
Preview or save the allowlisted discovery report for one device. Send terminal and saidas (step id to pasted output), initially with conferir:true. Preview returns normalized dados, additional passos and pronto without writing. Omit conferir to save when complete. Only allowlisted facts are saved, never raw commands. First report wins within one hour; identical retries do not rewrite. The discovery never creates a legacy measurement, sends a reading, installs software or creates a schedule. With Accept: text/plain the receipt is only `ok`.
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'saidas': {'type': 'object', 'description': 'Step id to pasted output; up to 10 entries, 4096 characters each, 8192 UTF-8 bytes total request.', 'maxProperties': 10, 'additionalProperties': {'type': 'string', 'maxLength': 4096}}, 'conferir': {'type': 'boolean', 'description': 'true previews without saving. Omit or use false to save a complete report.'}, 'terminal': {'enum': ['posix', 'powershell'], 'type': 'string', 'description': 'posix or powershell; required with saidas.'}, 'relatorio': {'type': 'string', 'maxLength': 8192, 'description': 'Alternative legacy key=value report. Do not combine with saidas.'}}}
set_device_input_active
Set device input active
Pauses or resumes one collector channel. Pausing keeps the channel, its credential and its configuration: batches the collector sends while paused are accepted and discarded, so nothing is stored or measured and the collector does not retry in a loop. Resuming stores the next batch again. The input central changes only a channel of the same owner, including one whose device was already deleted.
Destructive
Input schema
{'type': 'object', 'required': ['id', 'collector', 'active'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'active': {'type': 'boolean', 'description': 'false pauses, true resumes.'}, 'collector': {'enum': ['alloy', 'telegraf', 'opentelemetry', 'ncpa', 'collectd', 'snmp'], 'type': 'string', 'description': 'alloy, telegraf, opentelemetry, ncpa, collectd or snmp.'}}}
signal_exit_code
Signal exit code
The shell exit status: 0 behaves like a ping, 1-255 record the code as a failure. `curl -fsS $ORIGIN/in/ID/$?` at the end of a script is the whole integration. `0` behaves exactly like a plain ping; 1 to 255 record the code and leave the failure for the cron.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id', 'exit_code'], 'properties': {'id': {'type': 'string', 'description': 'Monitor ID, from `Monitor.ingest_url`.'}, 'exit_code': {'type': 'number', 'description': 'Exit status, 0 to 255. Outside that range it is a 400.'}}}
signal_fail
Signal fail
Says the run FAILED. The ingest never sends e-mail: the 5-minute cron turns it into an alert with reason `fail`, under the same one-per-24h cap. Failing is not proof of life either: the clock keeps running. The ingest never sends e-mail and never calls out — it records `alert_pending` and the cron turns it into an alert with `reason: "fail"` within 5 minutes, under the same one-per-24h cap. Works by GET or POST.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Monitor ID, from `Monitor.ingest_url`.'}}}
signal_start
Signal start
Says the run STARTED. Does not clear the dead-man clock: a routine that starts and hangs still becomes a miss. The next success records the duration. `start` is not proof of life: it does not move `last_event_at` and does not clear the miss counter, so a routine that starts and hangs still becomes a miss at the right time. The next success closes the run and records `last_duration_ms` — pass `?rid=` on both ends when runs can overlap, or the duration is measured against the wrong start. With `max_duration_sec` set on the monitor, a run left open past that ceiling alerts with `reason: "too_long"` on the next 5-minute check. Works by GET or POST.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Monitor ID, from `Monitor.ingest_url`.'}}}
status_feed_rotate
Status feed rotate
Rotates the status feed token; the previous URL stops working.
Destructive
Idempotent
Input schema
{'type': 'object', 'properties': {'guest_token': {'type': 'string'}}}
status_feed_url
Status feed URL
Public URL (JSON and RSS) with the status of all the owner's endpoints. The feed token only reads status: it does not create, change or delete. Whoever has the link sees the dashboard — treat it as a secret.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'guest_token': {'type': 'string'}}}
update_collection
Update collection
Renames one measurement, or stops and resumes reading it. The id never changes: it is the write symbol already sitting in a crontab, and renaming on a screen must not send anyone back to the machine to edit a line. Send only what you are changing; anything omitted stays as it is. `ativa:false` takes the measurement out of the fleet read — it keeps its history and its commands, stops costing a query, and comes back with `ativa:true`. It does NOT silence the machine: the symbol is signed and stands on its own at the ingest origin, so a device keeps sending until you remove its cron line. The answer is the collection as it now stands — draw the screen from it, not from a local copy.
Destructive
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'The signed 22-character collection symbol, or a legacy UUID v4.'}, 'nome': {'type': 'string', 'description': 'New name, 1–60 characters.'}, 'ativa': {'type': 'boolean', 'description': 'false stops reading this measurement; true resumes it.'}, 'grupo': {'type': 'string', 'description': 'New group, up to 40 characters; empty clears it.'}}}
update_environment
Update environment
Renames a device, and its measurements along with it. One machine has one name. The measurements carry a copy of it, so renaming here renames them too — leaving the old name on them would show the same machine twice in a list that groups by device. Its collector channels take the new name and group too in `GET /api/coletas` (`inputs[]`), and the group decides which dashboard tab the device is under. Send only what changes; what you omit stays. The detected environment is never rewritten: it is evidence of what that machine reported.
Destructive
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['3f2504e0-4f89-41d3-9a0c-0305e82c3301'], 'type': 'string', 'description': 'Device environment UUID v4; the report URL is a one-hour write capability.'}, 'nome': {'type': 'string', 'description': 'New device name, 1–60 characters.'}, 'grupo': {'type': 'string', 'description': 'New group, up to 40 characters; empty clears it.'}}}
History
Recent tool changes
Changed
pricing
Sept. 29, 2026, 2:59 a.m.
Changed
contact
Sept. 29, 2026, 2:59 a.m.
Changed
list_templates
Sept. 29, 2026, 2:59 a.m.
Changed
status_feed_rotate
Sept. 29, 2026, 2:59 a.m.
Changed
status_feed_url
Sept. 29, 2026, 2:59 a.m.
Changed
billing
Sept. 29, 2026, 2:59 a.m.
Changed
ping_slug
Sept. 29, 2026, 2:59 a.m.
Changed
ingest_key_rotate
Sept. 29, 2026, 2:59 a.m.
Changed
ingest_key
Sept. 29, 2026, 2:59 a.m.
Changed
signal_exit_code
Sept. 29, 2026, 2:59 a.m.
Changed
signal_fail
Sept. 29, 2026, 2:59 a.m.
Changed
signal_start
Sept. 29, 2026, 2:59 a.m.
Changed
ping_ingest
Sept. 29, 2026, 2:59 a.m.
Changed
list_events
Sept. 29, 2026, 2:59 a.m.
Changed
delete_endpoint
Sept. 29, 2026, 2:59 a.m.
Changed
get_endpoint
Sept. 29, 2026, 2:59 a.m.
Changed
import_crontab
Sept. 29, 2026, 2:59 a.m.
Changed
create_endpoint
Sept. 29, 2026, 2:59 a.m.
Changed
list_endpoints
Sept. 29, 2026, 2:59 a.m.
Changed
create_guest
Sept. 29, 2026, 2:59 a.m.
Changed
health
Sept. 29, 2026, 2:59 a.m.
Changed
api_index
Sept. 29, 2026, 2:59 a.m.
Changed
delete_environment
Sept. 29, 2026, 2:59 a.m.
Changed
update_environment
Sept. 29, 2026, 2:59 a.m.
Changed
delete_collection
Sept. 29, 2026, 2:59 a.m.
Changed
update_collection
Sept. 29, 2026, 2:59 a.m.
Changed
get_collection_series
Sept. 29, 2026, 2:59 a.m.
Changed
create_collection
Sept. 29, 2026, 2:59 a.m.
Changed
list_collections
Sept. 29, 2026, 2:59 a.m.
Changed
report_environment
Sept. 29, 2026, 2:59 a.m.
Discover
Similar MCP servers
shiply
now.shiply/shiply
Publishes and manages web applications with SQL databases, serverless functions, domains, email tests, client intake, contracts, …
OSIR Domain Registrar
com.osir/domain-registrar
Manages domain registration and transfers, DNS, VPS instances, SSH keys, hosted email, account funding, and related infrastructur…
hyperping
com.hyperping/hyperping
Manages uptime, HTTP, DNS, port, and API monitoring with outage diagnostics, latency and SLA metrics, alert integrations, escalat…
Boat House
com.boathousecloud/boathouse
Deploys and operates small containerized web applications with releases, rollbacks, persistent data, access controls, secrets, bi…
Plutus
com.plutus-cloud/plutus-cost-data
Analyzes cloud, AI, and SaaS costs with spend queries, budgets, anomalies, usage metrics, savings recommendations, dashboards, an…
Power Automate MCP Server by Flow Studio
io.github.ninihen1/flowstudio-mcp
Builds, updates, runs, monitors, debugs, and governs Microsoft Power Automate flows, environments, connectors, and run histories.
Tomorrow Central: Cloud Cost Sentinel
com.tomorrowcentral/aws-cloud-cost-sentinel
Looks up AWS prices, estimates architecture and workload costs, compares regions and architectures, and scans linked AWS accounts…
Atlasemoji
com.atlasemoji/mcp
Supports GIS validation, geofencing, location-aware workflows, operational data synchronization, manifests, routing, telemetry, a…