submit_research_job
Submit a research question or task to run as a background job with web search, X search, and code execution, returning a job ID to poll for results.
Instructions
Submit a long-running research task as a deferred xAI job and return
immediately. The job runs in the background with xAI's server-side web
search, X search, and code-execution tools attached; poll
get_research_job(job_id) for the result.
Args: prompt: The research question or task. model: Optional Grok model id. Leave unset to use the planning model. agent_count: Optional multi-agent fan-out — only 4 or 16 are accepted.
Returns:
A dict with job_id (pass it to get_research_job), status
("queued"), and the resolved model.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "submit_research_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| prompt | Yes | ||
| agent_count | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |