# Tako Docs

> Tako serves live financial, macroeconomic, and company data, plus lists of companies and the people at them, as source-grounded answers, structured knowledge cards, and embeddable charts. Build with four core APIs — Agent, Answer, Search, and Contents — plus Thin-Viz for your own data, all over real-time data with citations.

## Start here

- [Quickstart](https://docs.tako.com/documentation/getting-started/quickstart.md): Get an API key and make your first request in cURL, Python, or TypeScript.
- [What is Tako?](https://docs.tako.com/documentation/getting-started/what-is-tako/overview.md): What Tako is and when to reach for it.
- [Knowledge cards](https://docs.tako.com/documentation/getting-started/what-is-tako/knowledge-cards.md): The card object Tako returns and embeds.
- [Data sources](https://docs.tako.com/documentation/getting-started/what-is-tako/data-sources.md): Where Tako's data comes from and how fresh it is.

## Build with Tako — pick the right API

Each surface has a narrative Overview and a copy-paste "For Coding Agent" reference (endpoints, request/response shapes, cURL/Python/TypeScript). Agents building an integration should start from the For-Coding-Agent page.

- **Agent** — token-efficient deep research; dispatch a long-running run, then poll or stream results.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/agent/overview.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/agent/for-coding-agent.md): dispatch → poll/stream, run + result shapes.
- **Answer** — one written, cited answer in a single call.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/answer/overview.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/answer/for-coding-agent.md): `POST /api/v1/answer`, grounded answer + cards + web results.
- **Search** — fast structured knowledge cards, no LLM in the loop.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/search/overview.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/search/for-coding-agent.md): `POST /api/v3/search`, cards + web results.
- **Data Graph** — discover what data Tako has before you search; resolve names to nodes, explore relationships, pin node ids into Search. No credits consumed.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/data-graph/overview.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/data-graph/for-coding-agent.md): `GET /v1/graph/search` + `GET /v1/graph/related`, then `/v3/search` with `sources.data.node_ids`. Installable skill: see "Installable skill" below.
- **Contents** — the exact numbers behind an answer or card, as CSV.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/contents/overview.md) · [Pricing](https://docs.tako.com/documentation/integrating-tako/contents/pricing.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/contents/for-coding-agent.md): `POST /api/v1/contents`, download CSV / extracted text. Every row billed; read `export_pricing` or send `quote_only` before a large export.
- **Thin-Viz** — turn your own data into embeddable Tako cards.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/chart-creation/overview.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/chart-creation/for-coding-agent.md): `POST /api/v1/thin_viz/create/`.
- **Monitors** (experimental) — get a signed webhook or a Slack message when a condition on Tako data occurs: stock moves and levels, crypto and forex levels, and sports games.
  - [Overview](https://docs.tako.com/documentation/integrating-tako/monitors/overview.md) · [Webhook deliveries](https://docs.tako.com/documentation/integrating-tako/monitors/webhook-deliveries.md) · [Slack](https://docs.tako.com/documentation/integrating-tako/monitors/slack.md) · [For Coding Agent](https://docs.tako.com/documentation/integrating-tako/monitors/for-coding-agent.md): `POST /api/v1/notification_channels`, then `POST /api/v1/monitors`; deliveries follow Standard Webhooks, and a `slack_workflow` channel posts to a Slack workflow.
- [Embedding knowledge cards](https://docs.tako.com/documentation/integrating-tako/embedding-knowledge-cards.md): Drop live Tako cards into a web page.

## Installable skill — tako-graph-agent

Building an agentic application that integrates Tako Search? Install the ready-made skill instead of wiring the workflow yourself. It teaches a coding agent the full graph-grounded loop: resolve names to Data Graph nodes, read what data exists, compose pinned `/v3/search` queries, and report coverage gaps honestly.

Each file is hosted as a docs page whose first fenced code block is the complete file. Fetch these two pages and save the fenced content into your agent's skills directory:

1. [SKILL.md](https://docs.tako.com/skills/tako-graph-agent.md) → first code block, save to `.claude/skills/tako-graph-agent/SKILL.md`
2. [resolve-example.ts](https://docs.tako.com/skills/tako-graph-agent/resolve-example.md) → first code block, save to `.claude/skills/tako-graph-agent/resolve-example.ts` (reference implementation, requires `tako-sdk`: resolution loop, compose guards, cohort enumeration)

One-command install (extracts the first fenced block of each page):

```
mkdir -p .claude/skills/tako-graph-agent && \
  curl -fsSL https://docs.tako.com/skills/tako-graph-agent.md \
    | sed -n '/^```/,/^```/p' | sed '1d;$d' > .claude/skills/tako-graph-agent/SKILL.md && \
  curl -fsSL https://docs.tako.com/skills/tako-graph-agent/resolve-example.md \
    | sed -n '/^```/,/^```/p' | sed '1d;$d' > .claude/skills/tako-graph-agent/resolve-example.ts
```

## API Reference

- [Search v3](https://docs.tako.com/api-reference/search-v3.md) · [Answer](https://docs.tako.com/api-reference/answer.md) · [Contents](https://docs.tako.com/api-reference/contents.md)
- [Graph search](https://docs.tako.com/api-reference/graph-search.md) · [Graph related](https://docs.tako.com/api-reference/graph-related.md) · [Graph node](https://docs.tako.com/api-reference/graph-node.md)
- [Agent dispatch](https://docs.tako.com/api-reference/agent-dispatch.md) · [Agent poll](https://docs.tako.com/api-reference/agent-poll.md)
- [Thin-Viz create](https://docs.tako.com/api-reference/thinviz-direct-create.md)
- Monitors: [Create](https://docs.tako.com/api-reference/monitors-create.md) · [List](https://docs.tako.com/api-reference/monitors-list.md) · [Get](https://docs.tako.com/api-reference/monitors-get.md) · [Update](https://docs.tako.com/api-reference/monitors-update.md) · [Delete](https://docs.tako.com/api-reference/monitors-delete.md) · [Firings](https://docs.tako.com/api-reference/monitors-firings.md) · [Monitor types](https://docs.tako.com/api-reference/monitor-types.md) · [Sports games](https://docs.tako.com/api-reference/sports-games.md)
- Notification channels: [Create](https://docs.tako.com/api-reference/notification-channels-create.md) · [List](https://docs.tako.com/api-reference/notification-channels-list.md) · [Get](https://docs.tako.com/api-reference/notification-channels-get.md) · [Update](https://docs.tako.com/api-reference/notification-channels-update.md) · [Delete](https://docs.tako.com/api-reference/notification-channels-delete.md)

## Integrations

- [MCP server](https://docs.tako.com/documentation/integrations/mcp-server.md): Hosted Streamable HTTP endpoint at `https://mcp.tako.com/mcp` — connect Claude, ChatGPT, Cursor, VS Code, Codex, Windsurf and other MCP clients. On `https://mcp.tako.com/mcp` the listing is the same four tools — `tako_search`, `tako_available_data`, `tako_contents`, `tako_graph_related` — signed in or not. Free with no API key and no sign-in on a rate-limited tier, where `tako_search` runs and the rest ask you to sign in; `?tools=` is an allowlist that replaces the listing, so name the defaults you keep alongside `search_advanced`, `agent`, `company_agent`, or `visualize`. Agent calls return within 45 s, with the finished run or `status: "running"` and a `run_id` to resume with. Setup per client, plus the Claude Code plugin (`claude plugin install tako@tako`) and the Gemini CLI extension, which connect with `?tools=search,available_data,contents,graph_related,agent,company_agent`.
- [ChatGPT & Codex](https://docs.tako.com/documentation/integrations/chatgpt.md): One-click install from the OpenAI plugin directory — every ChatGPT plan including the free tier, no Developer mode, and the same listing covers Codex. Bundles the ChatGPT tool set (`tako_search`, `tako_available_data`, `tako_contents`, `tako_graph_related`, `tako_visualize`, `tako_agent`, `tako_company_agent`) plus the `tako-search` skill. Sign-in required.
- Agent Skills — installable skills that teach a coding agent how to use Tako well. The first two ship inside the Claude Code plugin (`claude plugin marketplace add TakoData/tako-mcp && claude plugin install tako@tako`) and the Gemini CLI extension; the third installs from this site (see "Installable skill" above).
  - [Tako Search](https://docs.tako.com/documentation/integrations/agent-skills/tako-search.md): sends any lookup to Tako — current events, facts, figures, or pages on any topic. Replaces the financial research, macroeconomics, and web traffic skills.
  - [Tako Agent](https://docs.tako.com/documentation/integrations/agent-skills/tako-agent.md): starts Tako's Answer Agent or Company Agent when the user asks for multi-step research, picks the agent, and resumes a running run with `run_id`.
  - [Graph agent](https://docs.tako.com/documentation/integrations/agent-skills/graph-agent.md): build agentic apps on the Data Graph + Search APIs — resolve, ground, pin, report gaps.
- [OpenAI-compatible API](https://docs.tako.com/documentation/integrations/openai-compatible-api.md) · [OpenAI tool calling](https://docs.tako.com/documentation/integrations/openai-tool-calling.md) · [OpenAI Responses API](https://docs.tako.com/documentation/integrations/openai-responses-api.md)
- [Anthropic tool calling](https://docs.tako.com/documentation/integrations/anthropic-tool-calling.md) · [Vercel AI SDK](https://docs.tako.com/documentation/integrations/vercel-ai-sdk.md)
- [Machine payments](https://docs.tako.com/documentation/integrations/machine-payments.md): Agent/machine payment flows.

## Additional Resources

- [Credits & billing](https://docs.tako.com/documentation/additional-resources/credits-and-billing.md)

## OpenAPI Spec

- [OpenAPI](https://docs.tako.com/api-reference/openapi.yaml)