Skip to content
Docs

Supply Audit tools for your agent

Status, findings, acknowledge, dismiss, apply, and scan over MCP. A 202 means a run started. Only a covered verdict means the scan reviewed your delivery.

1 min readVerified on our accountUpdated
On this page

Supply Audit is a set of MCP tools on the hosted connector at https://mcp.adprimezero.com/mcp. Each tool calls a public REST route under /supply-audit, so a script can do the same jobs. Connect your assistant has the setup.

Ask your agent to call these tools:

  • get_supply_audit_status (GET /supply-audit) to see whether the account is enrolled, the thresholds in force, and what the last run said.
  • activate_supply_audit / deactivate_supply_audit to turn the nightly scan on or off for the account. The scan does nothing until it is turned on.
  • update_supply_audit_policy (PATCH /supply-audit/policy) to change thresholds.
  • list_supply_audit_flags (GET /supply-audit/flags) to list findings.
  • acknowledge_supply_audit_flag or dismiss_supply_audit_flag to record your decision without changing targeting.
  • apply_supply_audit_flag (POST /supply-audit/flags/:id/apply) with a saf_ id to clone targeting. See Apply a Supply Audit finding.
  • run_supply_audit_scan (POST /supply-audit/scans) to request a run, and list_supply_audit_scans to list prior runs.

How to read a scan response

POST /supply-audit/scans returns 202 when a run starts, 200 with scanned: false when the interval gate skipped it, and 503 when provider credentials are missing. The default interval is 24 hours on a covered run. Failed coverage does not start that 24-hour clock, so a bad credential night does not lock you out of a retry.

Covered is the only green

coverage_verdict is covered, no_account_rows, no_provider_rows, or no_campaigns. Only covered means the scan reviewed your delivery. The run reads audited: false when it did not. Coverage verdict is the term. Incomplete coverage is not clean is the Lab piece.

A run that could not read your delivery is not a clean account. Check the verdict, not the finding count. The latest run also carries first_party_traffic_grade, the grade traffic is judged on: real landing visits, bot traps, and engagement.

The scan does not pause campaigns and does not apply exclusions by itself. Mode is recommend_only. Apply is a separate, targeting-only step.