Server definition
- Hash
- sha256:9138d4289b7059f79ae742aa1d6d7f470543fe83621389f6eb5b14fdad946b88
- What it is
- What a remote MCP server returned when asked what it offers: 27 tools
The blob, as servednamed by its sha256
{
"instructions": "monity.ai watches web pages over time and alerts the user when something they care about changes. Use it when the user wants to keep an eye on a page, be told when something changes (a price drop, a restock, a new post or listing, a status or policy change, a competitor update) or asks what changed on pages they watch. Do not use it for one-off reading, summarising or scraping of a page, or for reminders that do not depend on a web page. After creating a monitor, tell the user where alerts go and what the schedule costs in credits, from the result. When a result is shown as a monity.ai card, keep the reply short: add what the card does not show and do not repeat its list or table.",
"tools": [
{
"description": "Cancel the current editor-owned preview.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"previewId": {
"format": "uuid",
"type": "string"
},
"sessionId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"sessionId",
"previewId"
],
"type": "object"
},
"name": "cancel_editor_preview",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"actions": {
"description": "Ordered list of interactions to perform before each check, e.g. [{\"type\":\"CLICK\",\"selector\":\"#accept-cookies\"},{\"type\":\"WAIT\",\"value\":1500},{\"type\":\"CLICK\",\"selector\":\".load-more\"}]. Use this when the content to watch is behind a cookie banner, a tab, a \"show more\" control, or a dropdown. Max 20 steps. Script and JS/CSS injection steps are dashboard-only and rejected here.",
"items": {
"additionalProperties": false,
"properties": {
"active": {
"description": "Defaults to true; false keeps the step but skips it",
"type": "boolean"
},
"selector": {
"description": "How to find the element, as a Playwright selector. CSS by default (\"#accept-cookies\", \".product .price\"); a string starting with \"/\" is treated as XPath (\"//button[contains(text(),'Show more')]\"); Playwright engine prefixes also work, and \"text=Show more\" is usually the most robust choice for a button identified by its label rather than by a hashed class. Required for CLICK, TYPE, SELECT, MOUSEOVER and BLOCK.",
"type": "string"
},
"type": {
"description": "CLICK a element, TYPE text into it, SELECT a dropdown option, MOUSEOVER to reveal a menu, SCROLL (optionally by pixels), WAIT a number of milliseconds, REFRESH the page, or BLOCK (remove) an element from the page before comparing",
"enum": [
"CLICK",
"TYPE",
"SELECT",
"MOUSEOVER",
"SCROLL",
"WAIT",
"REFRESH",
"BLOCK"
],
"type": "string"
},
"value": {
"description": "Text to type for TYPE, option to pick for SELECT, milliseconds for WAIT (max 60000), pixels for SCROLL",
"type": [
"string",
"number"
]
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
},
"compareType": {
"description": "Comparison mode (default AUTO)",
"enum": [
"AUTO",
"VISUAL",
"TEXT",
"HTML"
],
"type": "string"
},
"frequency": {
"description": "Minutes between checks, as a string: '5', '15', '30', '60' (hourly), '180', '360', '720', '1440' (daily), '10080' (weekly), '302400' (monthly). Omit for the plan default. A frequency faster than the plan allows is raised to the plan minimum.",
"enum": [
"5",
"15",
"30",
"60",
"180",
"360",
"720",
"1440",
"10080",
"302400"
],
"type": "string"
},
"jsonPath": {
"description": "For JSON API endpoints: JSONPath to the value to monitor, e.g. $.data.items[0].price. Starts with '$'.",
"type": "string"
},
"keywords": {
"description": "TEXT monitors only: comma-separated keywords to watch for, e.g. \"sold out, unavailable\"",
"type": "string"
},
"keywordsAction": {
"description": "TEXT monitors only: alert when keywords are ADDED to the page (default) or REMOVED from it",
"enum": [
"ADDED",
"REMOVED"
],
"type": "string"
},
"labels": {
"description": "Label names to file the monitor under (up to 10); existing labels with the same name are reused.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"description": "Monitor name (defaults to the URL host/path)",
"type": "string"
},
"notifyConditions": {
"description": "Deterministic alert conditions on the extracted output (no AI credits). All conditions must pass. Requires the output to change. Mutually exclusive with notifyWhen. Not available for HTML monitors.",
"items": {
"additionalProperties": false,
"properties": {
"conditionType": {
"description": "con = output contains value, eq = equals, not = does not equal, gt/gte/lt/lte = numeric comparison of the extracted output",
"enum": [
"con",
"eq",
"not",
"gt",
"gte",
"lt",
"lte"
],
"type": "string"
},
"value": {
"description": "Comparison value (number for gt/gte/lt/lte)",
"type": [
"string",
"number"
]
}
},
"required": [
"conditionType",
"value"
],
"type": "object"
},
"type": "array"
},
"notifyWhen": {
"description": "Natural-language alert condition evaluated by AI on every check, e.g. 'notify me when the price drops below $500' or 'alert when the Pro plan changes'. Mutually exclusive with notifyConditions.",
"type": "string"
},
"outputExtractor": {
"description": "How to extract the monitored value from the page text: NUMBER pulls the first number (good for prices), REGEX applies outputExtractorPattern, NONE keeps the full text.",
"enum": [
"NONE",
"NUMBER",
"REGEX"
],
"type": "string"
},
"outputExtractorPattern": {
"description": "Regular expression for outputExtractor: REGEX — bare pattern or /pattern/flags; the first capture group (or full match) becomes the monitored output, e.g. 'In stock: (\\d+)'",
"type": "string"
},
"selector": {
"description": "CSS selector of ONE element to watch instead of the whole page (e.g. '.product-price' or '#stock-status'). Makes an element monitor that is found by this selector on every check; leave compareType unset.",
"type": "string"
},
"websiteUrl": {
"description": "Absolute http(s) URL of the page to monitor",
"type": "string"
},
"workspaceId": {
"description": "Workspace to create the monitor in (from list_workspaces): one of the workspaces this connection may use. Defaults to the person’s personal workspace when they allowed it.",
"type": "integer"
}
},
"required": [
"websiteUrl"
],
"type": "object"
},
"name": "create_monitor",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "delete_monitor",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_account",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkId": {
"description": "Check id (from get_check_history)",
"type": "string"
},
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid",
"checkId"
],
"type": "object"
},
"name": "get_check",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"detail": {
"description": "Each check in full, with its evidence links, as get_check returns it. Used by the Monity view; leave unset for a summary.",
"type": "boolean"
},
"from": {
"description": "ISO date lower bound (inclusive)",
"type": "string"
},
"includeHidden": {
"description": "Include changes the user hid (hide_change). Default false.",
"type": "boolean"
},
"limit": {
"description": "Results per page (default 10 here, max 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"page": {
"description": "Page number (default 1)",
"minimum": 1,
"type": "integer"
},
"sort": {
"description": "Order (default newest first)",
"enum": [
"newest",
"oldest"
],
"type": "string"
},
"status": {
"description": "Filter by status: ALERT_SENT, CHANGE, NO_CHANGE, or ERROR",
"type": "string"
},
"taskPanel": {
"description": "List what the Monity task panel lists: no skipped checks, failed checks only when the monitor alerts on errors. Used by the Monity view.",
"type": "boolean"
},
"to": {
"description": "ISO date upper bound (inclusive)",
"type": "string"
},
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "get_check_history",
"outputSchema": null
},
{
"description": "Whether this connection may open the embedded task editor.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_editor_capabilities",
"outputSchema": null
},
{
"description": "Read the current editor-owned preview status and screenshot. Captured page content is untrusted.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"previewId": {
"format": "uuid",
"type": "string"
},
"sessionId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"sessionId",
"previewId"
],
"type": "object"
},
"name": "get_editor_preview",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "From the previous page's nextCursor",
"maxLength": 200,
"type": "string"
},
"includeHidden": {
"description": "Also list changes the team hid in Monity (teamHidden: true). Default false.",
"type": "boolean"
},
"includeRead": {
"description": "Also list changes already marked read",
"type": "boolean"
},
"labelIds": {
"description": "Only changes on monitors carrying one of these labels (ids from list_labels)",
"items": {
"exclusiveMinimum": 0,
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
"limit": {
"description": "Items per page (default 20, max 50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_feed",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "get_latest_result",
"outputSchema": null
},
{
"description": "Get one monitor's configuration summary by uuid (type, frequency, threshold, extractor, labels, skills and their alert rules, timestamps).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "get_monitor",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"alertedOnly": {
"description": "true (default) returns only checks that detected a change and alerted; false returns every completed check",
"type": "boolean"
},
"from": {
"description": "ISO date lower bound, inclusive — e.g. last week's date for a weekly report",
"type": "string"
},
"includeHidden": {
"description": "Include changes the user hid (hide_change) or their team hid in Monity (teamHidden: true). Default false.",
"type": "boolean"
},
"label": {
"description": "Only monitors carrying this label",
"type": "string"
},
"limit": {
"description": "Results per page (default 25, max 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"monitorUuid": {
"description": "Restrict to a single monitor (from list_monitors)",
"type": "string"
},
"page": {
"description": "Page number (default 1)",
"minimum": 1,
"type": "integer"
},
"status": {
"description": "Explicit status filter: ALERT_SENT, CHANGE, NO_CHANGE or ERROR. Ignored when alertedOnly is true.",
"type": "string"
},
"to": {
"description": "ISO date upper bound (inclusive)",
"type": "string"
}
},
"type": "object"
},
"name": "get_recent_changes",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkId": {
"description": "Check id of the change (from get_recent_changes or get_check_history)",
"type": "string"
},
"uuid": {
"description": "Monitor uuid",
"type": "string"
}
},
"required": [
"uuid",
"checkId"
],
"type": "object"
},
"name": "hide_change",
"outputSchema": null
},
{
"description": "List the labels on monitors in the monity.ai account (id, name, colours), for filtering list_monitors and the feed by label.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_labels",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"active": {
"description": "Filter by active state",
"type": "boolean"
},
"compareTypes": {
"description": "Only monitors of these compare types",
"items": {
"maxLength": 30,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"createdOn": {
"description": "Only monitors created on this date (yyyy-mm-dd, UTC)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"frequencies": {
"description": "Only monitors checking at one of these frequencies (minutes, as strings)",
"items": {
"maxLength": 10,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"label": {
"description": "Filter by label name",
"type": "string"
},
"labelIds": {
"description": "Only monitors carrying one of these labels (ids from list_labels)",
"items": {
"exclusiveMinimum": 0,
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
"lastAlertFrom": {
"description": "Only monitors whose last change is on or after this ISO date",
"maxLength": 40,
"type": "string"
},
"lastAlertTo": {
"description": "Only monitors whose last change is on or before this ISO date",
"maxLength": 40,
"type": "string"
},
"limit": {
"description": "Results per page (default 25, max 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"page": {
"description": "Page number (default 1)",
"minimum": 1,
"type": "integer"
},
"search": {
"description": "Search monitor name or URL, case insensitive",
"maxLength": 200,
"type": "string"
},
"sort": {
"description": "Task list sort order; default newest created",
"enum": [
"NEWEST",
"OLDEST",
"LAST_CHECK",
"NEXT_CHECK",
"MOST_RECENT_ALERT",
"ALPHABETICAL_A-Z",
"ALPHABETICAL_Z-A",
"recent"
],
"type": "string"
},
"thresholds": {
"description": "Only monitors with one of these change thresholds",
"items": {
"maxLength": 20,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"workspaceId": {
"description": "Only monitors in this workspace (from list_workspaces)",
"type": "integer"
}
},
"type": "object"
},
"name": "list_monitors",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_workspaces",
"outputSchema": null
},
{
"description": "Fetch the configured public page in Monity and run its browser steps for an editor preview; does not save a task.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"sessionId": {
"format": "uuid",
"type": "string"
},
"settings": {
"additionalProperties": false,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"active": {
"type": "boolean"
},
"id": {
"maxLength": 100,
"type": "string"
},
"selector": {
"maxLength": 500,
"type": "string"
},
"type": {
"enum": [
"CLICK",
"TYPE",
"SELECT",
"MOUSEOVER",
"SCROLL",
"WAIT",
"REFRESH",
"BLOCK"
],
"type": "string"
},
"value": {
"anyOf": [
{
"maxLength": 1000,
"type": "string"
},
{
"type": "number"
}
]
}
},
"required": [
"type"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"active": {
"type": "boolean"
},
"aiNotificationActive": {
"type": "boolean"
},
"aiNotificationPrompt": {
"maxLength": 4000,
"type": "string"
},
"aiOutputActive": {
"type": "boolean"
},
"aiOutputPrompt": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"alertOnError": {
"type": "boolean"
},
"blockAds": {
"type": "boolean"
},
"compareDomElementAttributes": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"domSelector": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
]
},
"xpath": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"compareType": {
"enum": [
"AUTO",
"VISUAL",
"TEXT",
"HTML",
"ELEMENT"
],
"type": "string"
},
"crop": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"cropperPosition": {
"$ref": "#/properties/settings/properties/crop/anyOf/0/properties/imagePosition"
},
"height": {
"type": "number"
},
"imagePosition": {
"additionalProperties": false,
"properties": {
"x1": {
"minimum": 0,
"type": "number"
},
"x2": {
"minimum": 0,
"type": "number"
},
"y1": {
"minimum": 0,
"type": "number"
},
"y2": {
"minimum": 0,
"type": "number"
}
},
"required": [
"x1",
"y1",
"x2",
"y2"
],
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"imagePosition"
],
"type": "object"
},
{
"type": "null"
}
]
},
"disableJs": {
"type": "boolean"
},
"doubleCheckBeforeAlert": {
"type": "boolean"
},
"forceHtmlSnapshot": {
"type": "boolean"
},
"frequency": {
"enum": [
"5",
"15",
"30",
"60",
"180",
"360",
"720",
"1440",
"10080",
"302400"
],
"type": "string"
},
"jobSchedules": {
"items": {
"additionalProperties": false,
"properties": {
"exactDate": {
"maxLength": 30,
"type": "string"
},
"exactDateEnabled": {
"type": "boolean"
},
"frequency": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
]
},
"monthlyDayOfMonth": {
"anyOf": [
{
"maximum": 31,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
]
},
"timeConditionsEnabled": {
"type": "boolean"
},
"timeFrom": {
"maxLength": 5,
"type": "string"
},
"timeTo": {
"maxLength": 5,
"type": "string"
},
"timezone": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
]
},
"uuid": {
"maxLength": 100,
"type": "string"
},
"weekDays": {
"items": {
"enum": [
"Mo",
"Tu",
"We",
"Th",
"Fr",
"Sa",
"Su"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
}
},
"required": [
"weekDays",
"timeConditionsEnabled",
"timeFrom",
"timeTo",
"exactDateEnabled",
"exactDate"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"jobScreen": {
"enum": [
"ALL_PAGE",
"AREA"
],
"type": "string"
},
"jsonPath": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"keywords": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"keywordsAction": {
"maxLength": 30,
"type": "string"
},
"name": {
"maxLength": 200,
"type": "string"
},
"notes": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"notificationsEnabled": {
"type": "boolean"
},
"notifyConditions": {
"items": {
"additionalProperties": false,
"properties": {
"conditionType": {
"enum": [
"con",
"eq",
"not",
"gt",
"gte",
"lt",
"lte"
],
"type": "string"
},
"id": {
"maxLength": 100,
"type": "string"
},
"value": {
"anyOf": [
{
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
{
"type": "number"
}
]
}
},
"required": [
"conditionType",
"value"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"notifyConditionsEnabled": {
"type": "boolean"
},
"outputExtractor": {
"maxLength": 40,
"type": "string"
},
"outputExtractorPattern": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"saveHtml": {
"type": "boolean"
},
"saveOutput": {
"type": "boolean"
},
"scrollFullPage": {
"type": "boolean"
},
"threshold": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
]
},
"viewportHeight": {
"maximum": 2160,
"minimum": 200,
"type": "integer"
},
"viewportWidth": {
"maximum": 3840,
"minimum": 320,
"type": "integer"
},
"waitSeconds": {
"maximum": 60,
"minimum": 0,
"type": "number"
},
"websiteUrl": {
"format": "uri",
"maxLength": 2000,
"type": "string"
}
},
"required": [
"websiteUrl",
"name",
"compareType",
"frequency"
],
"type": "object"
}
},
"required": [
"sessionId",
"settings"
],
"type": "object"
},
"name": "load_editor_preview",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"all": {
"description": "Mark everything in the feed read",
"type": "boolean"
},
"checkId": {
"description": "The change to mark; omit with all: true",
"maxLength": 100,
"type": "string"
},
"unread": {
"description": "Put checkId back as unread",
"type": "boolean"
}
},
"type": "object"
},
"name": "mark_feed_read",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "open_monity",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"format": "uuid",
"type": "string"
},
"workspaceId": {
"exclusiveMinimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "open_task_editor",
"outputSchema": null
},
{
"description": "Pause a monitor (stops scheduled checks; history is kept).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "pause_monitor",
"outputSchema": null
},
{
"description": "Resume a paused monitor. Subject to the plan's active-monitor limit.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "resume_monitor",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "run_monitor",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"sessionId": {
"format": "uuid",
"type": "string"
},
"settings": {
"additionalProperties": false,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"active": {
"type": "boolean"
},
"id": {
"maxLength": 100,
"type": "string"
},
"selector": {
"maxLength": 500,
"type": "string"
},
"type": {
"enum": [
"CLICK",
"TYPE",
"SELECT",
"MOUSEOVER",
"SCROLL",
"WAIT",
"REFRESH",
"BLOCK"
],
"type": "string"
},
"value": {
"anyOf": [
{
"maxLength": 1000,
"type": "string"
},
{
"type": "number"
}
]
}
},
"required": [
"type"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"active": {
"type": "boolean"
},
"aiNotificationActive": {
"type": "boolean"
},
"aiNotificationPrompt": {
"maxLength": 4000,
"type": "string"
},
"aiOutputActive": {
"type": "boolean"
},
"aiOutputPrompt": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"alertOnError": {
"type": "boolean"
},
"blockAds": {
"type": "boolean"
},
"compareDomElementAttributes": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"domSelector": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
]
},
"xpath": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"compareType": {
"enum": [
"AUTO",
"VISUAL",
"TEXT",
"HTML",
"ELEMENT"
],
"type": "string"
},
"crop": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"cropperPosition": {
"$ref": "#/properties/settings/properties/crop/anyOf/0/properties/imagePosition"
},
"height": {
"type": "number"
},
"imagePosition": {
"additionalProperties": false,
"properties": {
"x1": {
"minimum": 0,
"type": "number"
},
"x2": {
"minimum": 0,
"type": "number"
},
"y1": {
"minimum": 0,
"type": "number"
},
"y2": {
"minimum": 0,
"type": "number"
}
},
"required": [
"x1",
"y1",
"x2",
"y2"
],
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"imagePosition"
],
"type": "object"
},
{
"type": "null"
}
]
},
"disableJs": {
"type": "boolean"
},
"doubleCheckBeforeAlert": {
"type": "boolean"
},
"forceHtmlSnapshot": {
"type": "boolean"
},
"frequency": {
"enum": [
"5",
"15",
"30",
"60",
"180",
"360",
"720",
"1440",
"10080",
"302400"
],
"type": "string"
},
"jobSchedules": {
"items": {
"additionalProperties": false,
"properties": {
"exactDate": {
"maxLength": 30,
"type": "string"
},
"exactDateEnabled": {
"type": "boolean"
},
"frequency": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
]
},
"monthlyDayOfMonth": {
"anyOf": [
{
"maximum": 31,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
]
},
"timeConditionsEnabled": {
"type": "boolean"
},
"timeFrom": {
"maxLength": 5,
"type": "string"
},
"timeTo": {
"maxLength": 5,
"type": "string"
},
"timezone": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
]
},
"uuid": {
"maxLength": 100,
"type": "string"
},
"weekDays": {
"items": {
"enum": [
"Mo",
"Tu",
"We",
"Th",
"Fr",
"Sa",
"Su"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
}
},
"required": [
"weekDays",
"timeConditionsEnabled",
"timeFrom",
"timeTo",
"exactDateEnabled",
"exactDate"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"jobScreen": {
"enum": [
"ALL_PAGE",
"AREA"
],
"type": "string"
},
"jsonPath": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"keywords": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"keywordsAction": {
"maxLength": 30,
"type": "string"
},
"name": {
"maxLength": 200,
"type": "string"
},
"notes": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"notificationsEnabled": {
"type": "boolean"
},
"notifyConditions": {
"items": {
"additionalProperties": false,
"properties": {
"conditionType": {
"enum": [
"con",
"eq",
"not",
"gt",
"gte",
"lt",
"lte"
],
"type": "string"
},
"id": {
"maxLength": 100,
"type": "string"
},
"value": {
"anyOf": [
{
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
{
"type": "number"
}
]
}
},
"required": [
"conditionType",
"value"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"notifyConditionsEnabled": {
"type": "boolean"
},
"outputExtractor": {
"maxLength": 40,
"type": "string"
},
"outputExtractorPattern": {
"$ref": "#/properties/settings/properties/aiNotificationPrompt"
},
"saveHtml": {
"type": "boolean"
},
"saveOutput": {
"type": "boolean"
},
"scrollFullPage": {
"type": "boolean"
},
"threshold": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
]
},
"viewportHeight": {
"maximum": 2160,
"minimum": 200,
"type": "integer"
},
"viewportWidth": {
"maximum": 3840,
"minimum": 320,
"type": "integer"
},
"waitSeconds": {
"maximum": 60,
"minimum": 0,
"type": "number"
},
"websiteUrl": {
"format": "uri",
"maxLength": 2000,
"type": "string"
}
},
"required": [
"websiteUrl",
"name",
"compareType",
"frequency"
],
"type": "object"
}
},
"required": [
"sessionId",
"settings"
],
"type": "object"
},
"name": "save_task_editor",
"outputSchema": null
},
{
"description": "Show a change the user hid with hide_change in their history and recent changes again.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkId": {
"description": "Check id of the hidden change",
"type": "string"
},
"uuid": {
"description": "Monitor uuid",
"type": "string"
}
},
"required": [
"uuid",
"checkId"
],
"type": "object"
},
"name": "unhide_change",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"actions": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"active": {
"description": "Defaults to true; false keeps the step but skips it",
"type": "boolean"
},
"selector": {
"description": "How to find the element, as a Playwright selector. CSS by default (\"#accept-cookies\", \".product .price\"); a string starting with \"/\" is treated as XPath (\"//button[contains(text(),'Show more')]\"); Playwright engine prefixes also work, and \"text=Show more\" is usually the most robust choice for a button identified by its label rather than by a hashed class. Required for CLICK, TYPE, SELECT, MOUSEOVER and BLOCK.",
"type": "string"
},
"type": {
"description": "CLICK a element, TYPE text into it, SELECT a dropdown option, MOUSEOVER to reveal a menu, SCROLL (optionally by pixels), WAIT a number of milliseconds, REFRESH the page, or BLOCK (remove) an element from the page before comparing",
"enum": [
"CLICK",
"TYPE",
"SELECT",
"MOUSEOVER",
"SCROLL",
"WAIT",
"REFRESH",
"BLOCK"
],
"type": "string"
},
"value": {
"description": "Text to type for TYPE, option to pick for SELECT, milliseconds for WAIT (max 60000), pixels for SCROLL",
"type": [
"string",
"number"
]
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Ordered list of interactions to perform before each check, e.g. [{\"type\":\"CLICK\",\"selector\":\"#accept-cookies\"},{\"type\":\"WAIT\",\"value\":1500},{\"type\":\"CLICK\",\"selector\":\".load-more\"}]. Use this when the content to watch is behind a cookie banner, a tab, a \"show more\" control, or a dropdown. Max 20 steps. Script and JS/CSS injection steps are dashboard-only and rejected here. Replaces the whole list; read the monitor first to keep existing steps. Pass null to remove them all."
},
"active": {
"description": "true resumes checks, false pauses them",
"type": "boolean"
},
"frequency": {
"description": "Minutes between checks, as a string: '5', '15', '30', '60' (hourly), '180', '360', '720', '1440' (daily), '10080' (weekly), '302400' (monthly). Omit for the plan default. A frequency faster than the plan allows is raised to the plan minimum.",
"enum": [
"5",
"15",
"30",
"60",
"180",
"360",
"720",
"1440",
"10080",
"302400"
],
"type": "string"
},
"jsonPath": {
"description": "For JSON API endpoints: JSONPath to the value to monitor, e.g. $.data.items[0].price. Starts with '$'. Pass null to clear.",
"type": [
"string",
"null"
]
},
"keywords": {
"description": "TEXT monitors only: comma-separated keywords to watch for, e.g. \"sold out, unavailable\" Pass null to clear.",
"type": [
"string",
"null"
]
},
"keywordsAction": {
"description": "TEXT monitors only: alert when keywords are ADDED to the page (default) or REMOVED from it",
"enum": [
"ADDED",
"REMOVED"
],
"type": "string"
},
"labels": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Label names for the monitor (up to 10). New names create the label in the account; existing labels with the same name are reused. Replaces the monitor's labels: include the ones it already has (get_monitor lists them) to keep them. [] or null removes them all."
},
"name": {
"description": "New monitor name",
"type": "string"
},
"notifyConditions": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"conditionType": {
"description": "con = output contains value, eq = equals, not = does not equal, gt/gte/lt/lte = numeric comparison of the extracted output",
"enum": [
"con",
"eq",
"not",
"gt",
"gte",
"lt",
"lte"
],
"type": "string"
},
"value": {
"description": "Comparison value (number for gt/gte/lt/lte)",
"type": [
"string",
"number"
]
}
},
"required": [
"conditionType",
"value"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Deterministic alert conditions on the extracted output (no AI credits). All conditions must pass. Requires the output to change. Mutually exclusive with notifyWhen. Not available for HTML monitors. Pass null to clear."
},
"notifyWhen": {
"description": "Natural-language alert condition evaluated by AI on every check, e.g. 'notify me when the price drops below $500' or 'alert when the Pro plan changes'. Mutually exclusive with notifyConditions. Pass null to clear.",
"type": [
"string",
"null"
]
},
"outputExtractor": {
"description": "How to extract the monitored value from the page text: NUMBER pulls the first number (good for prices), REGEX applies outputExtractorPattern, NONE keeps the full text.",
"enum": [
"NONE",
"NUMBER",
"REGEX"
],
"type": "string"
},
"outputExtractorPattern": {
"description": "Regular expression for outputExtractor: REGEX — bare pattern or /pattern/flags; the first capture group (or full match) becomes the monitored output, e.g. 'In stock: (\\d+)' Pass null to clear.",
"type": [
"string",
"null"
]
},
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "update_monitor",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkId": {
"description": "Check id (from get_check_history), or 'latest' for the most recent completed check. Defaults to 'latest'.",
"type": "string"
},
"maxHeight": {
"description": "Height bound, default 3000, max 4000. Full-page captures are very tall, so this is what usually decides the scale.",
"type": "integer"
},
"maxWidth": {
"description": "Longest width to scale to, default 1200, max 4000",
"type": "integer"
},
"uuid": {
"description": "Monitor uuid (from list_monitors)",
"type": "string"
},
"view": {
"description": "Which image: 'current' (default), 'previous', or 'diff' with changes highlighted",
"enum": [
"current",
"previous",
"diff"
],
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "view_check_screenshot",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:9138d4289b7059f79ae742aa1d6d7f470543fe83621389f6eb5b14fdad946b88 | sha256sum