Skip to content
advardeDeveloper docs
v1.0

Save monitor

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp
Write

Available subject to your connection’s permissions.

Description: Create or update a persistent alert or report schedule. Only the creator receives optional email; in-app notifications are workspace-visible. Rules never change ads. Updates require revision; set enabled=false to stop. Scheduled work uses the creator’s current workspace access, independent of chat sessions.

Method: tools/call · ads_save_monitor

Output: Tool data is returned in result.structuredContent and as JSON text in result.content. Inspect result.isError before using the result. Individual output fields depend on the operation.

Access: Requires the applicable write scopes, workspace role, and account permissions.

Authentication

Use an MCP access token from MCP connections, or connect through OAuth. Send your token in the Authorization: Bearer header.

For full protocol initialization and tool discovery, use an MCP client. These examples show individual JSON-RPC requests.

Tool arguments

Send these fields inside params.arguments. The tool name is sent as params.name.

monitor_idstringoptional
format: "uuid"
expected_revisionintegeroptional
minimum: 1
namestringrequired
minLength: 1maxLength: 200
kindenumrequired
enum: ["alert","report"]
enabledbooleanrequired
configobjectrequired
additionalProperties: false
EXPAND CONFIG
account_idstringoptional
format: "uuid"
campaign_idstringoptional
pattern: "^[A-Za-z0-9_-]{1,255}$"
ruleenumoptional
enum: ["spend_threshold","zero_delivery","pacing","ctr_drop","review_status","competitor_updates"]
thresholdnumberoptional
minimum: 0maximum: 1000000000000
expected_spendnumberoptional
minimum: 0maximum: 1000000000000exclusiveMinimum: 0
min_impressionsintegeroptional
minimum: 1maximum: 1000000000
window_hoursintegeroptional
minimum: 1maximum: 744
interval_hoursintegeroptional
minimum: 1maximum: 744
cadenceenumoptional
enum: ["daily","weekly","monthly"]
emailbooleanrequired
brandstringoptional
minLength: 0maxLength: 200
collectionstringoptional
minLength: 0maxLength: 200
Full JSON Schema
{
  "type": "object",
  "properties": {
    "monitor_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 1
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "kind": {
      "enum": [
        "alert",
        "report"
      ]
    },
    "enabled": {
      "type": "boolean"
    },
    "config": {
      "type": "object",
      "properties": {
        "account_id": {
          "type": "string",
          "format": "uuid"
        },
        "campaign_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{1,255}$"
        },
        "rule": {
          "enum": [
            "spend_threshold",
            "zero_delivery",
            "pacing",
            "ctr_drop",
            "review_status",
            "competitor_updates"
          ]
        },
        "threshold": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000000
        },
        "expected_spend": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000000,
          "exclusiveMinimum": 0
        },
        "min_impressions": {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000000000
        },
        "window_hours": {
          "type": "integer",
          "minimum": 1,
          "maximum": 744
        },
        "interval_hours": {
          "type": "integer",
          "minimum": 1,
          "maximum": 744
        },
        "cadence": {
          "enum": [
            "daily",
            "weekly",
            "monthly"
          ]
        },
        "email": {
          "type": "boolean"
        },
        "brand": {
          "type": "string",
          "minLength": 0,
          "maxLength": 200
        },
        "collection": {
          "type": "string",
          "minLength": 0,
          "maxLength": 200
        }
      },
      "required": [
        "email"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "name",
    "kind",
    "enabled",
    "config"
  ],
  "additionalProperties": false
}

Responses

200Successful protocol response

Inspect result.isError for tool-level failures, even when the HTTP status is 200.

202Notification accepted

MCP notifications return no JSON-RPC response body.

400Invalid request

Check the JSON-RPC envelope, parameters, and protocol version.

406Not acceptable

Accept must include application/json and text/event-stream.

429Rate limited

Wait for the Retry-After interval before making another request.

401Unauthorized

A valid, unexpired MCP bearer token is required.

403Access denied

Your connection needs access to this workspace and the requested operation.

Advarde MCP API v1.0