ask
Ask the agent. Full pipeline (schema, queries, analysis). Sync within deadline_seconds; else {status:pending,job_id} — poll request_status/read_response. Pass a stable thread id (UUID) on every call for conversation context. The result carries thread_id, the thread actually used; re-send that value on later calls.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ask"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Optional role override; defaults to admin for MCP callers. | |
| agent | No | Bundle name. Inferred from the Host header when missing. | |
| thread | No | Persistent conversation id. Either `thread` or the legacy `thread_id` alias must be set. | |
| message | No | User prompt for the agent. Either `message` or the legacy `question` alias must be set. | |
| question | No | Legacy apples-compat alias for `message`. Ignored when `message` is set. | |
| thread_id | No | Legacy apples-compat alias for `thread`. Ignored when `thread` is set. | |
| publisher_id | No | Publisher the research is bound to. Only the dedicated research credential may send it; other callers are refused. | |
| deadline_seconds | No | Synchronous wait budget. Default 240. |