research_company
Start the research agent on a company: it reads the public website and maps the company onto the schema with sources and confidence. Returns a run id; poll get_research. Needs a key.
Needs a keyMCP tool
Parameters
- workspacestringrequired
- companystringrequired
Company slug; the client is 'client'
- focusstringoptional
Focused research: what to look into, e.g. 'their dispatch software'. Omit for a wide run.
max 200 chars
Example call
Agents call tools by name; you rarely write this by hand. It is here so you can test the server from a shell or your own code.
{
"name": "research_company",
"arguments": {
"workspace": "acme-builders",
"company": "rival-co"
}
}Response
The result is one text content block holding this JSON (abbreviated here). Errors come back with isError: true and a message such as Error 401: … or Invalid input: ….
Response
{
"id": "8f0c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91",
"status": "queued"
}Over REST
The same call without MCP: POST/api/v1/workspaces/:slug/companies/:company/research