Assignments

List the monitor assigned to each platform

monitors.assignments.list

Lists the platform tabs of this organization's Monitors page that have a monitor assigned: one item per platform, in the screen's order, with the template, where it comes from (its own ORGANIZATION template, an INHERITED one from the workspace or a SYSTEM monitor), whether the template is still available (it exists, is published and is built for that platform; when it is not, the tab shows the monitor picker) and whether the platform is connected (without a connection the tab is hidden). Platforms with no monitor are not listed; the list is always whole (one item per platform, up to 12). Each item says who assigned it (created_by, created_by_name) and who changed it last. For an account, call it on the account (org_id).

Scope

monitors:read

Permission

View the module

MCP tool

monitors_assignments_listOn the full surface; on the compact one, mb_execute_operation with id: "monitors.assignments.list".

Declared cost: up to 101 reads and 0 writes per call (they count against the daily quota).

Parameters

No parameters.

Response

Errors

Example

curl "https://api.mb-suite.com/v1/monitors/assignments" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/monitors/assignments" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Get the monitor assigned to a platform

monitors.assignments.get

Returns the monitor assigned to one platform tab of this organization (platform_id is one of the platforms with a monitor tab, such as google_ads or meta_ads): the template, its source, whether it is still available and whether the platform is connected. Not found (monitor_assignment_not_found) when that tab has no monitor.

Scope

monitors:read

Permission

View the module

MCP tool

monitors_assignments_getOn the full surface; on the compact one, mb_execute_operation with id: "monitors.assignments.get".

Declared cost: up to 2 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Assign a monitor to a platform

monitors.assignments.set

Shows a monitor template in one platform tab of this organization's Monitors page, replacing the one it had. The template must be reachable (the organization's own, a published one of its workspace for an account, or a published system monitor; source narrows where to look), published (template_not_published otherwise) and built for that platform (template_platform_mismatch otherwise). The tab can be assigned before the platform is connected; it shows once there is a connection. Idempotent: assigning the same monitor again changes nothing (changed false). Returns the assignment. Requires edit access to Monitors.

Scope

monitors:write

Permission

Edit in the module

MCP tool

monitors_assignments_setOn the full surface; on the compact one, mb_execute_operation with id: "monitors.assignments.set".

Events it can emit

monitors.monitor.assigned

Declared cost: up to 4 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "template_id": "TEMPLATE_ID"
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "template_id": "TEMPLATE_ID"
}'

Remove the monitor from a platform

monitors.assignments.clear

Removes the monitor assigned to one platform tab of this organization: the tab goes back to the monitor picker. The template itself is not touched and can be assigned again with monitors.assignments.set. Idempotent: on a tab with no monitor nothing changes (cleared false). Requires edit access to Monitors.

Scope

monitors:write

Permission

Edit in the module

MCP tool

monitors_assignments_clearOn the full surface; on the compact one, mb_execute_operation with id: "monitors.assignments.clear".

Events it can emit

monitors.monitor.unassigned

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}/clear" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}/clear" \
  -H "Authorization: Bearer $MB_TEST_KEY"