Tako MCP Server

Tako’s Model Context Protocol server searches the live web and a proprietary graph of licensed, continuously updated data in the same call. Ask for a figure with context and one search returns both — cited, and with the chart behind the number. The graph covers finance and markets, company KPIs, companies and the people at them, economics, website and app traffic, sports, weather, elections, prediction markets, demographics, energy, real estate, health, and more. Web search reaches whatever the graph doesn’t, so one tool call stands in for two. There’s nothing to install or host. Point your client at one endpoint:

https://mcp.tako.com/mcp

It speaks Streamable HTTP, the current MCP remote transport. tako_search answers before you sign in, on a lower rate limit.

Connect

Every configuration here works as written, with no credentials. Sign in to run every tool on your own limits. Your client opens a Tako sign-in window the first time it connects, and approving it mints an API key for you, so there’s nothing to copy. CLI and editor clients also take an API key, from tako.com/console/api-keys — in most config files that’s one more block beside the URL:

"headers": { "Authorization": "Bearer tako_sk_YOUR_KEY" }

Chat hosts — ChatGPT, Claude.ai, and Claude Desktop — connect through their vendor’s cloud, so they only take the sign-in.

One-click install

Cursor

VS Code

Kiro

Each button adds the server and starts the Tako sign-in.

Claude Code

The plugin installs the four default tools, both agent tools, and Tako’s two skills in two commands. tako-search sends lookups to Tako, and tako-agent starts an agent when you ask for one.

claude plugin marketplace add TakoData/tako-mcp
claude plugin install tako@tako

To sign in, run /mcp, select tako, then choose Authenticate. If you update the plugin from version 1.4.5 or earlier, sign in again the same way. The new version connects to a new URL, and Claude Code doesn’t carry the old sign-in over. For the default tools without the skills, add the server directly:

claude mcp add --transport http tako https://mcp.tako.com/mcp

Verify with claude mcp list. Keep one Tako connection active — the plugin and a manual entry each register the full tool set, so together they give you two copies of every tool.

Codex

Install Tako from the OpenAI plugin directory. One install adds Tako’s tools and skills, and the same listing covers ChatGPT. The listing uses Tako’s ChatGPT surface, which asks you to sign in. See ChatGPT & Codex.

To add the server by hand instead:

codex mcp add tako --url https://mcp.tako.com/mcp

Sign in with codex mcp login tako. Codex can also read an API key from the environment rather than storing it in the config file:

export TAKO_API_TOKEN="tako_sk_YOUR_KEY"
codex mcp add tako --url https://mcp.tako.com/mcp --bearer-token-env-var TAKO_API_TOKEN

Either command writes ~/.codex/config.toml, which you can also edit by hand:

[mcp_servers.tako]
url = "https://mcp.tako.com/mcp"
bearer_token_env_var = "TAKO_API_TOKEN"

In the Codex app, open Settings → Plugins → Add MCP server and paste the endpoint URL instead.

ChatGPT

Install Tako from the OpenAI plugin directory. One install adds Tako’s tools and skills. It works on every ChatGPT plan, including the free tier, and doesn’t require Developer mode. The listing uses Tako’s ChatGPT surface, which asks you to sign in. See ChatGPT & Codex.

To add Tako as a custom connector instead: Requires a ChatGPT Pro, Business, or Enterprise plan with Developer mode enabled. Turn on Developer mode in ChatGPT’s settings. Then in Plugins, click +, name the plugin, and set the Connector URL:

https://mcp.tako.com/mcp

That’s Tako’s generic endpoint: four tools, with charts as static images. The ChatGPT-specific surface https://mcp.tako.com/mcp/chatgpt adds tako_visualize, tako_agent, tako_company_agent, and an interactive chart widget, and accepts only the OAuth sign-in, not an API key. In the ChatGPT app, open Settings → Plugins → Add MCP server and paste the same URL.

Claude Desktop

Requires a Claude Pro, Max, Team, or Enterprise plan. Claude.ai takes the same steps. Open Settings → Connectors → Add custom connector and paste the endpoint:

https://mcp.tako.com/mcp

Sign in when the Tako window opens. Claude Desktop and Claude.ai connect through Anthropic’s cloud, so neither accepts an Authorization header — to use an API key, bridge the endpoint with mcp-remote from Other clients.

Cursor

Add Tako to Cursor

The button adds the server and starts the Tako sign-in. Or add ~/.cursor/mcp.json (or a project .cursor/mcp.json) by hand:

{
  "mcpServers": {
    "tako": {
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

Cursor detects the transport.

VS Code

Add Tako to VS Code

The button adds the server and starts the Tako sign-in. Or add .vscode/mcp.json by hand:

{
  "servers": {
    "tako": {
      "type": "http",
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

The top-level key is servers; in user settings.json it nests under "mcp". VS Code prompts for the sign-in when you authenticate. An API key goes through a prompted input rather than a plain header:

{
  "servers": {
    "tako": {
      "type": "http",
      "url": "https://mcp.tako.com/mcp",
      "headers": { "Authorization": "Bearer ${input:tako-key}" }
    }
  },
  "inputs": [
    { "id": "tako-key", "type": "promptString", "description": "Tako API key", "password": true }
  ]
}

Other clients

Windsurf

Add Tako to ~/.codeium/windsurf/mcp_config.json. The key is serverUrl, not url:

{
  "mcpServers": {
    "tako": {
      "serverUrl": "https://mcp.tako.com/mcp"
    }
  }
}

Gemini CLI

The extension installs the four default tools, both agent tools, the tako-search and tako-agent skills, and the /data, /chart, and /coverage commands:

gemini extensions install https://github.com/TakoData/tako-mcp

gemini mcp add --transport http tako https://mcp.tako.com/mcp

{
  "mcpServers": {
    "tako": {
      "httpUrl": "https://mcp.tako.com/mcp"
    }
  }
}

Fill an Authorization header completely or leave it out. Gemini substitutes an unset ${VAR} literally, and rejects the malformed header rather than ignoring it, so a half-filled key breaks a connection that no key at all would have made.

Zed

Zed calls MCP servers “context servers”. Add one to Zed’s settings.json:

{
  "context_servers": {
    "tako": {
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

Cline

In the Cline MCP Servers panel, open the Remote Servers tab, set the URL to https://mcp.tako.com/mcp, and choose the Streamable HTTP transport. The equivalent config:

{
  "mcpServers": {
    "tako": {
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

Roo Code

Open Roo Code’s MCP settings (Edit Global MCP) and add Tako. The type must be streamable-http:

{
  "mcpServers": {
    "tako": {
      "type": "streamable-http",
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

Kiro

Add Tako to Kiro

The button adds the server and starts the Tako sign-in. Or add ~/.kiro/settings/mcp.json (or workspace .kiro/settings/mcp.json) by hand:

{
  "mcpServers": {
    "tako": {
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

Warp

In Warp, open Settings → Agents → MCP servers → + Add, choose the URL (Streamable HTTP) option, and paste:

{
  "mcpServers": {
    "tako": {
      "url": "https://mcp.tako.com/mcp"
    }
  }
}

Goose

Run goose configure → Add Extension → Remote Extension (Streamable HTTP) and set the endpoint to https://mcp.tako.com/mcp. The desktop app has the same flow under Extensions → Add custom extension.Goose takes an API key as a Custom Request Header: Authorization: Bearer tako_sk_YOUR_KEY.

Antigravity

In Antigravity, open the side-panel ”…” menu → Manage MCP Servers → View raw config, which names the config file path for your install. Add Tako, where the key is serverUrl:

{
  "mcpServers": {
    "tako": {
      "serverUrl": "https://mcp.tako.com/mcp"
    }
  }
}

OpenCode

Add Tako to opencode.json:

{
  "mcp": {
    "tako": {
      "type": "remote",
      "url": "https://mcp.tako.com/mcp",
      "enabled": true
    }
  }
}

Any other client

Any client that speaks Streamable HTTP can use Tako. Point it at https://mcp.tako.com/mcp.A client that supports only stdio servers reaches the endpoint through the mcp-remote bridge:

{
  "mcpServers": {
    "tako": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tako.com/mcp"]
    }
  }
}

To authenticate with an API key, pass the header through an env var with no space after the colon. That’s the documented workaround for an npx argument-escaping bug:

{
  "mcpServers": {
    "tako": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tako.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer tako_sk_YOUR_KEY" }
    }
  }
}

GitHub

TakoData/tako-mcp

Smithery

tako/tako

Try it

Once the tools appear, ask your agent something Tako’s data answers directly. Say “use Tako” in your first message to guarantee the agent calls the tool.

“Use Tako — what was Nvidia’s most recent quarterly revenue?” — one tako_search call returns the figure in the top card’s headline, with its source and the chart behind it.
“Use Tako to compare US CPI, core CPI, and PCE inflation.” — the agent fans out narrow tako_search calls, one per metric, and synthesizes them.
“What data does Tako have on Costco?” — once you’re signed in, tako_available_data lists the coverage and surfaces name ambiguity, and is never charged.
“How much traffic does stripe.com get?” — monthly website visits, one of the graph’s twelve domains.

If the answer comes back with a chart and a source line, you’re connected.

Tools

On https://mcp.tako.com/mcp, the listing is the same four tools whether or not you sign in; only ?tools= changes it. What sign-in changes is what runs: tako_search answers on a lower rate limit, and the other three reply with sign-in instructions in place of a result.

Tool	Without sign-in	What it does
`tako_search`	Runs	The entry point for a data question. Searches Tako’s data graph and the live web in one call, and returns ranked knowledge cards — each with a headline value that’s often the answer itself, graph node ids, and an interactive chart — plus web results. The top card renders inline on hosts that support it. Four parameters: `query`, `sources`, `country_code`, `locale`. Retrieval is best with narrow queries (one entity + one metric, e.g. `"Nvidia revenue"`) fanned out in parallel.
`tako_available_data`	Asks you to sign in	Never charged. Discovers what proprietary, continuously updated data exists for an entity or metric, and returns the canonical name to search on — search matches the graph’s names, not your phrasing. Also returns node ids for graph traversal and, when the target is unambiguous, a ready-to-run `next_call`.
`tako_contents`	Asks you to sign in	Fetches what’s behind results the model already has, up to 10 urls per call: a card’s data rows, or a web page’s extracted text (pass `query` to get back only the matching passages). Rows bill per 1,000 delivered, up to 2,000 per card — set `max_rows` when the recent rows are enough. Cards must be marked `exportable: true`.
`tako_graph_related`	Asks you to sign in	Never charged. Explores what a graph node connects to: its metrics, the entities a metric covers, competitors, industry, index membership, and sources. Pass a `node_id` alone for the map of every relation group, or add `relation` to page one group.

Every tool answers on two channels at once: structured content for code to read, and a rendered markdown summary for the model. Both carry the same fields, so a host that surfaces only one loses nothing. On connect, the server also advertises MCP server instructions that hosts like Claude and Claude Code place in the model’s system prompt. They steer data and metric questions to Tako ahead of the host’s built-in web search, and note that Tako covers the live web too — so one call can stand in for a separate web search on mixed questions. The host’s own web search stays the fallback for anything outside Tako’s coverage.

Opt-in tools

Four heavier tools are off by default to keep the tool surface small. Select them with ?tools= on the connection URL. This URL adds both agents, and it’s the one the Claude Code plugin and the Gemini CLI extension connect to:

https://mcp.tako.com/mcp?tools=search,available_data,contents,graph_related,agent,company_agent

?tools= is an allowlist that replaces the default listing, not an addition to it. ?tools=agent lists tako_agent and nothing else. Name every tool you rely on, defaults included.

Each value is a tool name, with the tako_ prefix optional. An unrecognized value is dropped, and a ?tools= that names nothing recognizable falls back to the defaults, so a typo never leaves the connection with no tools — but it does drop the tool it misspells. Opt-in tools all need a signed-in connection.

Tool name	Enables	What it’s for
`search_advanced`	`tako_search_advanced`	One synthesized, citation-backed answer with `include_answer: true`, or a call `tako_search` can’t express: per-source counts, inline card rows, graph pins, web domain and category filters, and `effort: deep`. It takes the v3 search body with `sources` split into separate `data` and `web` blocks, plus `include_answer` and `output_schema` (fills a JSON Schema from the same evidence), neither of which the search body carries. `data.include_contents` inlines each card’s rows and bills per card — cap it with `data.max_rows`. Returns the same payload as `tako_search`, minus the inline chart render — `embed_url` is still there to click through.
`agent`	`tako_agent`	Tako’s Answer Agent, for research that ranks, aggregates, or computes across metrics: the 10 largest UK software companies by revenue, countries ranked by GDP, a growth rate across several periods. Returns a written answer with numbered citations, the chart cards it built, and a `thread_id` to pass back for a follow-up.
`company_agent`	`tako_company_agent`	Tako’s Company Agent, for lists of companies or people that match a set of facts: a screen by location, industry, status, or founding date; a company’s officers and directors; or companies filtered by a financial metric such as revenue. Returns a written answer with numbered citations, the list cards it built, and a `thread_id`. Takes `effort`: `medium` by default, `high` for a slower and stronger run, and `low`, which can’t filter by financial metrics.
`visualize`	`tako_visualize`	Publishes an embeddable Tako chart from your own data — the Thin-Viz API as a tool. The card is public and permanent, readable by anyone with the link, so confirm with the user before calling and never send sensitive data.

An agent run can take several minutes, longer than most hosts hold a tool call open. Each agent call returns within 45 seconds. If the run is still going, the result has status: "running" and a run_id. The model calls the same tool again with that run_id to keep waiting, so the run is never lost or started twice. On https://mcp.tako.com/mcp, the server also sends the run’s steps as MCP progress notifications. The tako-agent skill tells the model which agent fits a question and how to resume a run.

Pin the sources

By default, the model picks the sources on each call, and a search covers both Tako data and the web. To fix the sources for the whole connection, add ?sources= to the /mcp URL. Use it to evaluate Tako data on its own:

https://mcp.tako.com/mcp?sources=data

Value	Searches and agent runs use
`data`	Tako data only, with no web results.
`web`	The web only, with no Tako cards.
`data,web`	Both, on every call.

The pin applies to tako_search, tako_search_advanced, tako_agent, and tako_company_agent. Each one drops its sources input, so the model can’t override the pin, and every call sends the pinned value, agent thread follow-ups included. On tako_search_advanced, the block for the source you left out disappears instead. The server instructions and tool descriptions state the pin, so the model knows what the connection can return. tako_contents, tako_available_data, and tako_graph_related take no sources input. To keep a web-only connection off the graph, combine the pin with ?tools=:

https://mcp.tako.com/mcp?tools=search&sources=web

In a shell command, such as claude mcp add, quote a URL that has more than one parameter, because the shell reads & as the end of the command.

An invalid or empty value, such as ?sources=dta, fails the connection with an HTTP 400 that names the parameter.
An agent follow-up on a thread that started with different sources fails. Start a new thread.
/mcp/chatgpt ignores ?sources=.

?sources= doesn’t turn off your client’s own web search tool. To measure Tako data with no web results at all, turn off that tool in the client too.

Build Tako into your agent

Building your own agent rather than connecting a client? Hand your coding agent the integration prompt at the top of the Quickstart. It reads the docs, asks the right questions, and wires Tako in the best way for your stack (this MCP server or the direct API, whichever fits).

MCP is the simplest way to give an agent Tako — one endpoint, zero glue code — but it trades control for convenience: connection-level auth and a fixed tool surface. For production integrations that need typed SDKs, streaming, retries, and fine-grained request control, call the API directly or follow an integration guide (OpenAI Responses, Anthropic tool calling, Vercel AI SDK).

Troubleshooting

Tools don't appear after connecting

Confirm your client supports the Streamable HTTP transport and is pointed at https://mcp.tako.com/mcp (not a .../sse path). Restart the client so it re-runs the tools/list handshake. If you sent an API key, check that the Authorization: Bearer tako_sk_… header is set and the key hasn’t been revoked. Tako rejects an invalid key rather than treating the connection as signed out.

A specific tool is missing (tako_agent, tako_company_agent, tako_search_advanced, tako_visualize)

Those four are opt-in. Reconnect with ?tools= on the URL and restart the client. The parameter replaces the default listing, so name the defaults too:

https://mcp.tako.com/mcp?tools=search,available_data,contents,graph_related,agent,company_agent

See Tools for the token table.If a default tool is missing instead, look for a ?tools= on the URL that left it out — a misspelled token included. An unrecognized token is dropped and the rest are honored, so ?tools=serch,contents lists tako_contents alone. Only a ?tools= that names nothing recognizable falls back to the defaults.The Claude Code plugin and the Gemini CLI extension pin their connection URL, which lists the four defaults and both agents. For tako_search_advanced or tako_visualize there, add the server yourself with the parameter, and remove the packaged connection so you don’t get two copies of every tool.

Results still include the source you pinned out

Check that the pin applied. A pinned connection’s tako_search has no sources input, and its server instructions name the pinned sources. If sources is still there, check the parameter name: the server ignores an unknown name, such as ?source=data, and connects with the default sources. Restart the client after you change the URL.The pin also needs at least one of tako_search, tako_search_advanced, tako_agent, or tako_company_agent in the listing. Otherwise, it has nothing to apply to.The Claude Code plugin and the Gemini CLI extension pin their connection URL, so you can’t add ?sources= to it. Add the server yourself with the parameter, and remove the packaged connection so you don’t get two copies of every tool.If web results still appear on ?sources=data, they can come from your client’s own web search tool, which the pin doesn’t affect.

The Claude Code plugin stopped using your account after an update

Claude Code stores a sign-in for each server URL. Version 1.5.0 of the plugin connects to a new URL, so an update from 1.4.5 or earlier leaves the plugin on the free tier without prompting you. Run /mcp, select tako, and choose Authenticate to sign in again.

If a tool replies with sign-in instructions, the connection isn’t signed in. All four default tools are listed either way, but only tako_search answers without credentials. Sign in through your client, or add an Authorization: Bearer tako_sk_… header, then retry the call.If a signed-in connection hits a rate limit, you’ve reached your account’s limit rather than the credential-free one — check pricing for your plan’s rates.tako_available_data and tako_graph_related are never charged, so use them for coverage checks instead of a priced search.

You don’t need a pre-existing API key — approving the sign-in mints a per-host key automatically (named MCP: <client> at tako.com/console/api-keys). If a host stops authenticating, remove and re-add the connector to mint a fresh key. Deleting a host’s MCP: <client> key at the console kills that host’s access; rotating your key kills every host’s grant at once. Tako keeps at most ten MCP keys — connecting an eleventh host trims the oldest.

tako_contents refuses a card

Export requires the card to be marked exportable: true in the tako_search result. Cards from license-protected sources — S&P Global, FactSet, Visible Alpha, CoinMarketCap — come back non-exportable. That's a licensing boundary, not an error, so retrying doesn't help: read the figure from the card's description, which carries the latest value and its range, and cite the chart. Cards from open sources such as FRED, OECD, BIS, and Fiscal.ai export normally. Web URLs are always fetchable.

Next steps

Get an API key

Run every tool on your own limits

Pricing

Rates and free credits

Build an integration

One prompt for your coding agent

Getting Started

Build with Tako

API Reference

Integrations

Additional Resources

Connect

One-click install

Cursor

VS Code

Kiro

Claude Code

Codex

ChatGPT

Claude Desktop

Cursor

Add Tako to Cursor

VS Code

Add Tako to VS Code

Other clients

Add Tako to Kiro

GitHub

Smithery

Try it

Tools

Opt-in tools

Pin the sources

Build Tako into your agent

Troubleshooting

Next steps

Get an API key

Pricing

Build an integration

​Connect

​One-click install

Cursor

VS Code

Kiro

​ Claude Code

​ Codex

​ ChatGPT

​ Claude Desktop

​ Cursor

Add Tako to Cursor

​ VS Code

Add Tako to VS Code

​Other clients

Add Tako to Kiro

GitHub

Smithery

​Try it

​Tools

​Opt-in tools

​Pin the sources

​Build Tako into your agent

​Troubleshooting

​Next steps

Get an API key

Pricing

Build an integration

Connect

One-click install

Claude Code

Codex

ChatGPT

Claude Desktop

Cursor

VS Code

Other clients

Try it

Tools

Opt-in tools

Pin the sources

Build Tako into your agent

Troubleshooting

Next steps