Optimly MCP

Get Agent Activity

In short

Read tenant-scoped AI agent and crawler request activity for a connected site. Returns bounded totals, agent families, verified counts, requested paths, and observation state. Declared identities are not verified.

Product: Optimly MCP
Updated: 2026-08-10

get_agent_activity · Free · Authentication required

When to use

Use to see which AI agents and crawlers are visiting a connected site and what they request.

Access

All plans with a connected Site Insights site

Parameters

Parameter	Type	Required	Description
`site_id`	`string`	Yes	Connected Site Insights site ID.
`brand_id`	`uuid`	Yes	Authorized brand ID.
`start_date`	`string`	Yes	Inclusive local start date in YYYY-MM-DD.
`end_date`	`string`	Yes	Inclusive local end date in YYYY-MM-DD.
`limit`	`number`	No	Maximum family and page rows. Default 25.

Example prompt

Which AI crawlers hit our site last week, and which pages did they request?

Example request

{
  "site_id": "site_123",
  "brand_id": "00000000-0000-4000-8000-000000000001",
  "start_date": "2026-08-01",
  "end_date": "2026-08-07"
}