# Tako Docs

> Tako serves live financial, macroeconomic, and company data 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/`.
- [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` (runnable reference implementation: 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)

## 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`, or `visualize`. Setup per client, plus the Claude Code plugin (`claude plugin install tako@tako`).
- Agent Skills — installable skills that teach a coding agent how to use Tako well. The first three ship inside the Claude Code plugin (`claude plugin marketplace add TakoData/tako-mcp && claude plugin install tako@tako`) or the Gemini CLI extension; the fourth installs from this site (see "Installable skill" above).
  - [Financial research](https://docs.tako.com/documentation/integrations/agent-skills/financial-research.md): company financials and markets — revenue, earnings, margins, valuation, comparisons.
  - [Macroeconomics](https://docs.tako.com/documentation/integrations/agent-skills/macroeconomics.md): CPI/PCE, unemployment, GDP, policy rates, demographics, cross-country comparisons.
  - [Web traffic](https://docs.tako.com/documentation/integrations/agent-skills/web-traffic.md): SimilarWeb monthly visits, app MAU, head-to-head domains, top-sites rankings.
  - [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)