> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tako.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Visualizations

> Find existing Tako knowledge cards and charts to view or embed

<Note>
  This skill depends on the Tako MCP server. See the [MCP Server](/documentation/integrations/mcp-server) page for more details.
</Note>

This skill teaches your coding agent to search Tako for existing knowledge cards — interactive, ready-to-embed charts — that answer a natural-language query, instead of writing prose.

<Tabs>
  <Tab title="Claude Code">
    ## Copy and Paste in Claude Code

    Click the copy button on the code block below and paste it into Claude Code. Claude will set up both the Tako MCP connection and the skill for you.

    ```text theme={null}
    Set up Tako's "search visualizations" skill for me.

    1) Ensure the Tako MCP server is connected — install it, or update it if it already exists (set $TAKO_API_TOKEN first, or paste your tako_sk_… token in place of it). Run:
    claude mcp add --transport http tako https://mcp.tako.com/mcp --header "Authorization: Bearer ${TAKO_API_TOKEN}"

    2) Create the skill at .claude/skills/search-visualizations/SKILL.md with exactly this content:

    ---
    name: search-visualizations
    description: Use when the user wants to find existing Tako knowledge cards / charts to view or embed — not a written answer. Triggers on "find a chart of", "search Tako for", "is there a card for", "show me a graph of".
    ---
    Use the Tako MCP `tako_search` tool to find existing Tako knowledge cards (interactive charts) plus optional web results for a natural-language query.

    - Call `tako_search` with the query. It searches **both Tako's curated data and the live web by default** — pass `sources` only to narrow to one (`["tako"]` curated-only or `["web"]` web-only). Tune `count` (1–20) and `effort` (`"instant"` for the fastest cached path, else `"fast"`). Parameter detail: https://docs.tako.com/documentation/integrating-tako/guides/search
    - This finds existing cards for a *specific, known* thing — a value, a time series, or a direct comparison of two named entities. If the question instead needs *figuring something out* (resolving a cohort like "which companies match…", or ranking/filtering a set by criteria), reach for the `tako_agent` deep-research tool instead.
    - The top card auto-renders inline as a chart — narrate the data and reference it ("as the chart above shows"). Always end your reply with `[Open in Tako](embed_url)` once for the top card. Do NOT echo `![...](image_url)` markdown for the top card — it duplicates the inline render.
    - For additional cards, link each one's `embed_url` (to embed) or `webpage_url` (to open) so the user can use them.
    - To embed a card live in a web page, put its `embed_url` in an `<iframe>` and add the resize-listener script so the card auto-sizes to its content — see the embedding guide: https://docs.tako.com/documentation/integrating-tako/guides/embedding-knowledge-cards#example-dynamic-resizing-script
    - Each call consumes credits.

    3) Confirm the tako_search tool is available — I may need to restart Claude Code to load the new MCP server.
    ```
  </Tab>

  <Tab title="Codex">
    ## Copy and Paste in Codex

    Click the copy button on the code block below and paste it into Codex. It will set up both the Tako MCP connection and the skill for you.

    <Note>
      A Tako API token must be set in your shell — Codex stores only the variable name (`--bearer-token-env-var TAKO_API_TOKEN`) and reads `TAKO_API_TOKEN` from your environment each time it connects. Run `export TAKO_API_TOKEN=tako_sk_…` first (get a token from the [API keys console](https://developer.tako.com/console/api-keys)), and add it to your shell profile so it persists.
    </Note>

    ```text theme={null}
    Set up Tako's "search visualizations" skill for me.

    1) Ensure the Tako MCP server is connected — install it, or update it if it already exists (with your Tako token in $TAKO_API_TOKEN). Run:
    codex mcp add tako --url https://mcp.tako.com/mcp --bearer-token-env-var TAKO_API_TOKEN

    2) Create the skill at .claude/skills/search-visualizations/SKILL.md with exactly this content:

    ---
    name: search-visualizations
    description: Use when the user wants to find existing Tako knowledge cards / charts to view or embed — not a written answer. Triggers on "find a chart of", "search Tako for", "is there a card for", "show me a graph of".
    ---
    Use the Tako MCP `tako_search` tool to find existing Tako knowledge cards (interactive charts) plus optional web results for a natural-language query.

    - Call `tako_search` with the query. It searches **both Tako's curated data and the live web by default** — pass `sources` only to narrow to one (`["tako"]` curated-only or `["web"]` web-only). Tune `count` (1–20) and `effort` (`"instant"` for the fastest cached path, else `"fast"`). Parameter detail: https://docs.tako.com/documentation/integrating-tako/guides/search
    - This finds existing cards for a *specific, known* thing — a value, a time series, or a direct comparison of two named entities. If the question instead needs *figuring something out* (resolving a cohort like "which companies match…", or ranking/filtering a set by criteria), reach for the `tako_agent` deep-research tool instead.
    - The top card auto-renders inline as a chart — narrate the data and reference it ("as the chart above shows"). Always end your reply with `[Open in Tako](embed_url)` once for the top card. Do NOT echo `![...](image_url)` markdown for the top card — it duplicates the inline render.
    - For additional cards, link each one's `embed_url` (to embed) or `webpage_url` (to open) so the user can use them.
    - To embed a card live in a web page, put its `embed_url` in an `<iframe>` and add the resize-listener script so the card auto-sizes to its content — see the embedding guide: https://docs.tako.com/documentation/integrating-tako/guides/embedding-knowledge-cards#example-dynamic-resizing-script
    - Each call consumes credits.

    3) Also create .claude/skills/search-visualizations/agents/openai.yaml so Codex auto-triggers the skill:

    interface:
      display_name: "Search Visualizations"
      short_description: "Find existing Tako knowledge cards and charts to view or embed"
      default_prompt: "Use $search-visualizations to find Tako cards for my query."
    policy:
      allow_implicit_invocation: true

    Then symlink it for discovery: ln -s ../../.claude/skills/search-visualizations .agents/skills/search-visualizations

    4) Confirm the tako_search tool is available.
    ```
  </Tab>
</Tabs>