# Tako Deep-Research Agent Run

> Tako Deep-Research Agent Run is a paid API for AI agents from Tako at tako.com, paid per call via MPP, $1/call, status unknown (last checked 2026-10-11).

Dispatches an async multi-step deep-research agent that searches curated data and/or the web to answer complex analytical queries, returning a run ID to poll for results

## Facts

- Endpoint: POST https://tako.com/api/mpp/v1/agent/runs?utm_source=zero.xyz
- Price: $1/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Tako
- Docs: https://tako.com
- Website: https://tako.com
- Tags: data, visualization, charts, research, search, answers, agents, reports, datasets, analytics, ai
- Canonical page: https://www.zero.xyz/c/tako-deep-research-agent-run-438303ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vL5IuaJ2uQFB1sQJ_7eKL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tako-deep-research-agent-run-438303ee -d '<json body>'
```

Example prompt: Run a deep research on Tako comparing Nvidia and AMD headcount, revenue, and R&D spending from 2013 to today — use medium effort and search both curated data and the web.

## When to prefer this

Choose this endpoint when the user's question requires multi-step research across multiple entities, time periods, or metrics — especially when a single search or answer won't suffice. Prefer this over Tako's synchronous Answer or Search endpoints when the query is complex, comparative, or requires synthesizing data from multiple sources. Use the 'low' effort mode for simpler factual questions needing speed, and 'medium' (default) for deep analytical reports. Use thread_id to continue a prior conversation thread with follow-up questions.

## Known failure modes

- Missing required 'query' field returns a 422 validation error
- Invalid thread_id UUID format causes a 422 error
- Invalid source_indexes values (not 'data' or 'web') cause a 422 error
- Invalid effort level value (not 'low' or 'medium') causes a 422 error
- Payment not provided or insufficient USDC results in a 402 payment required error
- Downstream research agent timeout may result in a failed status when polling
- Invalid BCP-47 locale string may cause unexpected language behavior

## How this service works

Run a deep-research agent (multi-step research, async)

## Output

An immediate 202 response containing a run_id (UUID string) and a status field always set to 'running'. The agent must then poll the dedicated status endpoint (/api/mpp/v1/agent/runs/status) using the run_id to retrieve the completed research results, citations, and data once the async multi-step agent finishes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "AgentRunRequest",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "title": "Query",
   "examples": [
    "Compare Nvidia and AMD headcount since 2013"
   ],
   "description": "Natural-language request for the agent."
  },
  "effort": {
   "anyOf": [
    {
     "enum": [
      "low",
      "medium"
     ],
     "type": "string",
     "title": "AgentEffortLevel",
     "description": "Effort level for an agent run. `low` returns fast results for simple\nqueries; `medium` runs deeper multi-step analysis and takes longer, and is\nwhat an omitted effort resolves to. Published verbatim on /openapi.json —\nkeep this public-facing."
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Agent effort. 'low' returns fast results for simple queries; 'medium' returns deeper analysis across multiple entities and metrics (slower). Omit it and Tako uses medium."
  },
  "locale": {
   "type": "string",
   "title": "Locale",
   "default": "en-US",
   "description": "BCP-47 locale. Drives the language of the agent's answer (a non-English locale makes the agent respond in that language) and the locale used when rendering card preview images. Defaults to en-US."
  },
  "timezone": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Timezone",
   "default": null,
   "description": "IANA timezone (for example, 'America/New_York'). The agent uses it to render dates and times in card preview images. It does not affect the returned data."
  },
  "thread_id": {
   "anyOf": [
    {
     "type": "string",
     "format": "uuid"
    },
    {
     "type": "null"
    }
   ],
   "title": "Thread Id",
   "default": null,
   "description": "Existing thread to continue (follow-up). Omit to start a new thread."
  },
  "source_indexes": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "enum": [
       "data",
       "web"
      ],
      "type": "string"
     }
    },
    {
     "type": "null"
    }
   ],
   "title": "Source Indexes",
   "default": null,
   "examples": [
    [
     "data"
    ],
    [
     "web"
    ],
    [
     "data",
     "web"
    ]
   ],
   "description": "Which sources the agent may use: 'data' (curated knowledge), 'web' (open-web search), or both. Omit it on a new thread and the agent uses both; omit it on a follow-up and the run keeps the thread's sources. Tako accepts the legacy value 'tako' as a synonym for 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "MppAgentRunDispatchResponse",
 "required": [
  "run_id",
  "status"
 ],
 "properties": {
  "run_id": {
   "type": "string",
   "title": "Run Id"
  },
  "status": {
   "type": "string",
   "title": "Status",
   "description": "Always \"running\" on dispatch; poll /api/mpp/v1/agent/runs/status."
  }
 },
 "description": "202 body of POST /api/mpp/v1/agent/runs.",
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tako-deep-research-agent-run-438303ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tako.com](https://www.zero.xyz/host/tako.com/llms.txt)