Get the AI tools overview of the company
Return the headline numbers of the AI tools on the company’s devices as JSON: devices reporting, distinct tools, MCP servers and those reaching a host outside the device, devices with remote AI connections and with a high or critical finding; then counts per tool kind (kinds.<kind>), per severity (findingsBySeverity.<severity>) and per AI service (aiConnectionsByService.<service>), the rules with findings, the remote MCP hosts, the AI services and the 10 most installed tools. Use it for counts and rankings; to list tools use getAiTools, to list findings getAiFindings. AI tools are what Primo finds on Macs (assistant apps, coding agents, IDE plugins, browser extensions, MCP servers, AI connections, agent instruction files), as of the last report (lastSyncedAt of getAiToolsOverview, every 5 minutes), with Primo’s severities, less the findings the company’s AI tools settings ignore. They are not the software catalog (getSoftwares, getDeviceSoftware), the company’s own AI agents (listAgents) nor AI credits (getAiUsage). A company without AI tools monitoring gets a 403, final.
Authorizations
Use your Primo API key in the Authorization header as Bearer <API_KEY>.
Response
When Primo last read the devices' reports (ISO 8601); null before any
Devices that reported an AI inventory to Primo
-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991Distinct MCP servers
-9007199254740991 <= x <= 9007199254740991Distinct MCP servers reached on a host outside the device
-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991Counts per tool kind, every kind present
Counts per severity, every severity present
Remote AI connections per service seen, e.g. anthropic, openai, unclassified
Every rule with a raised finding, worst first; the rules the company's settings ignore are left out
Hosts outside the device that MCP servers reach, most devices first
The 10 tools found on the most devices