Get the AI tools found on the devices
Return every AI tool found on the devices, most installed first, as JSON data: its toolKey, kind, name, vendor, how many devices have it and run it, its versions (topVersion the most common) and its worst finding severity. Narrow with kind, search (name or vendor) and worstSeverity (a list, e.g. critical and high). Use it for “how many devices run Claude Code” or “which MCP servers are installed”; for the devices and findings of one tool use getAiTool, for counts only getAiToolsOverview. 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>.
Query Parameters
Keep the items whose worst finding has one of these severities (repeat the param or comma separate)
critical, high, medium, low Part of the tool name or vendor
Keep the tools of one kind
assistant_app, coding_agent, ide_plugin, browser_extension, mcp_server