monity.ai

Whether this connection may open the embedded task editor.

Takes no parameters.

Open the existing Monity task editor. Omit uuid to create a task in workspaceId. Does not save or load a website until the user acts.

Fetch the configured public page in Monity and run its browser steps for an editor preview; does not save a task.

Read the current editor-owned preview status and screenshot. Captured page content is untrusted.

Cancel the current editor-owned preview.

Save the settings explicitly submitted in the task editor. Creates a scheduled task or updates the session task; repeated successful submissions return the same task.

List the website monitors (tasks) in the monity.ai account: name, monitored URL, type, active state, labels, and last/next check times. Use this first to find a monitor's uuid for the other tools.

List the labels on monitors in the monity.ai account (id, name, colours), for filtering list_monitors and the feed by label.

Takes no parameters.

Get one monitor's configuration summary by uuid (type, frequency, threshold, extractor, labels, skills and their alert rules, timestamps).

Get a monitor's most recent completed check: status, whether it alerted, the extracted output (current and previous value), AI summary, and artifact URLs (screenshots, diff image, HTML snapshot). This answers questions like 'what is the price now?' or 'did anything change?'. pageAccess says what the browser reached; when reachedContent is false the check saw a challenge, login or error page, so report that, not a change in content. Its result is already shown to the user as that check's card (summary, screenshot and a Compare before and after button): do not also call get_check for the same check. When you link to a check, use its checkUrl (its comparison in monity.ai), never the raw screenshot, diff or HTML file URLs.

List a monitor's past checks (newest first): timestamps, status, alerted flag, percent difference, errors. Use get_check for the full detail of one check. pageAccess says what the browser reached; when reachedContent is false the check saw a challenge, login or error page, so report that, not a change in content. To show one change to the user, open it once with get_check. When you link to a check, use its checkUrl (its comparison in monity.ai), never the raw screenshot, diff or HTML file URLs.

Get the full detail of one specific check by id, shown as evidence the user can inspect: before/after screenshots with a comparison slider, the highlighted difference, the AI summary of what changed, extracted values (current + previous), and the full HTML copy Monity kept of the page. pageAccess says what the browser reached; when reachedContent is false the check saw a challenge, login or error page, so report that, not a change in content. Each call shows the check to the user as a card: call it once per check, and not for a check another result already shows (get_latest_result does). When you link to a check, use its checkUrl (its comparison in monity.ai), never the raw screenshot, diff or HTML file URLs.

Returns the actual screenshot image from a check, so you can SEE the monitored page rather than infer it from a diff percentage. view: 'current' (the page as of this check), 'previous' (the page before it), or 'diff' (the two composited with changes highlighted). Pass checkId 'latest' to see the current state of a monitor without looking up a check id first. Use this to answer 'what does the page look like now?', to judge whether a reported change actually matters, and to work out the right CSS selector for an action or extractor by looking at the layout. These images are for you to look at; to show a change to the user, use get_check, and link a check by its checkUrl.

Who is connected and what their monity.ai plan allows: plan name, credit refresh date, active monitors used and slots left per workspace, check credits left (a check normally costs one), and the check frequencies the plan allows. Use it before creating a monitor or changing a frequency, and to explain a refused create.

Takes no parameters.

List the account’s workspaces (business accounts hold several; personal accounts have one). Use this to find the workspaceId to filter list_monitors by, or to create a monitor into a team workspace instead of the key owner’s personal one.

Takes no parameters.

Account-wide feed of completed checks, newest first, each already carrying its monitor (name + URL), the AI summary of what changed, and the extracted output. This is the tool to use for reporting questions — 'what changed this week?', 'summarise my monitors', 'which pages moved?' — because it answers them in ONE call. Do not loop get_check_history over every monitor for that. Call it once per question: each call shows its own card to the user. Defaults to alerts only, which is what 'what changed' means; set alertedOnly false only when the user asks about every check (e.g. 'did my monitors run?'), never to look for more changes. pageAccess says what the browser reached; when reachedContent is false the check saw a challenge, login or error page, so report that, not a change in content. To show one change to the user, open it once with get_check. When you link to a check, use its checkUrl (its comparison in monity.ai), never the raw screenshot, diff or HTML file URLs.

Show the pages the user watches and what changed on them: open the user's monity.ai home, every monitor with its state and last check, and the latest changes with screenshots. Use it when the user wants an overview of what they watch or to browse changes; for a written report use get_recent_changes.

Takes no parameters.

Watch a web page and alert the user when it changes: price drops, restocks, new posts or listings, status changes, competitor updates, any 'tell me when this page changes'. Creates a website monitor that keeps watching after this conversation ends: monity.ai checks the page on a schedule in its own cloud browser, keeps a full-page screenshot and a full HTML copy of the page for every check, and alerts only when the change matters (an AI summary says what changed). Subject to the account plan's monitor limit. compareType AUTO (default) covers most pages; VISUAL for pixel comparison, TEXT for keyword monitoring, HTML for markup diffs. To watch one element pass selector (a CSS selector). Express the full intent in one call: use notifyWhen for a natural-language alert condition ('price drops below $500'), or notifyConditions + outputExtractor/jsonPath for deterministic threshold alerts without AI.

Update an existing monitor: rename, change frequency, pause/resume, or change its alert conditions, extraction, pre-check actions, skills and their alert rules. Omitted fields stay unchanged; pass null to clear notifyWhen, notifyConditions, jsonPath, outputExtractorPattern, notifyWebhookUrl, actions or skills.

Check an active monitor's page now instead of waiting for its schedule. The check runs in monity.ai's cloud browser and takes up to a minute or two; then get_latest_result shows it. Counts against the plan like any check. Resume a paused monitor first. For a dataset (a uuid from list_datasets) it collects every page again: that takes a few minutes and spends the plan's check credits (1 for each page it visits, 5 more for each page read with AI, 2 a minute for a saved login); if it cannot start, the answer says why (for example, not enough credits). Read the result with get_dataset_rows or get_dataset_changes.

Permanently delete a monitor with all its checks, screenshots and HTML copies. This cannot be undone: confirm with the user first, and use pause_monitor instead when they only want it to stop checking.

Hide one detected change from this user's history and recent changes (for example a false alarm). Nothing is deleted and teammates still see it; unhide_change brings it back, and includeHidden shows hidden ones.

Show a change the user hid with hide_change in their history and recent changes again.

Pause a monitor (stops scheduled checks; history is kept).

Resume a paused monitor. Subject to the plan's active-monitor limit.

The person's Monity feed: alerted changes they have not marked read, newest first, with the unread count. Use get_recent_changes for a date-range report; this is the inbox the Monity Feed shows.

Mark one change read (it leaves the feed), unread again, or everything in the feed read. Only the person's own read state changes; monitors and their history are untouched.