MCP tool reference
Nine tools, all bounded by the calling customer key and its scopes.
Available tools
| Tool | Arguments | Scope |
|---|---|---|
| recursift_fleet_overview | {} | agents:read |
| recursift_list_agents | cursor?, limit? | agents:read |
| recursift_ask_agent | agent_id, question | query:write |
| recursift_ask_fleet | agent_ids, question, timeout_seconds? | query:write |
| recursift_get_query | query_id | query:read |
| recursift_search_findings | search?, cursor?, limit? | query:read |
| recursift_start_resource_query | persistence_mode, template_id, template_version, time_range, agent_ids | resources:query |
| recursift_get_resource_query | query_id | resources:query |
| recursift_cancel_resource_query | query_id | resources:query |
The three resource tools start, read and cancel an ephemeral resource query. persistence_mode must be ephemeral. They do not fall back to the saved ask tools. A current client against an older API gets an error from the resource tool. An older client does not list the resource tools.
Discovery and presence
Fleet overview reports presence counts for the first 100 accessible endpoints, plus next_cursor. It is not a complete fleet census when another page exists. Use list_agents pagination to enumerate further endpoints. Tool discovery lists all nine tools; invocation still enforces scopes.
Asynchronous questions
ask_agent and ask_fleet return a job receipt immediately. ask_fleet requires 1–100 explicit endpoint IDs and accepts a 5–120 second timeout. get_query accepts the receipt’s id as query_id; it returns current findings, counts and unanswered IDs. Questions are at most 500 characters.
{
"agent_ids": [
"ENDPOINT_A",
"ENDPOINT_B"
],
"question": "What operating system are you running?",
"timeout_seconds": 120
}Stored finding search
search_findings searches materialized API answer summaries by substring. It does not collect new endpoint evidence or run local vector retrieval. It returns findings, next_cursor and a coverage explanation. No result is not evidence of absence.