TakoData-tako-mcp

プラグイン（推奨） — MCP 接続と Tako に同梱されている検索・調査スキルを一度にインストールでき、API キーの発行や管理も不要で、すぐに無料プランで利用できます。

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

これで完了です。匿名の無料プランで tako_search がすぐに使えます。すべてのツールとご自身のアカウントの利用上限を有効にするには、OAuth で一度認証してください。Claude Code 内で /mcp を実行し、tako を選択して、Authenticate を選びます。ブラウザーが開き、Tako アカウントでサインインすると、ホストごとの API キーが自動的に発行されます（tako.com/console/api-keysで確認および無効化できます）。同じ OAuth フローは Claude.ai のプラグインでも使われます。プラグインの Tako コネクターは、トークンを貼り付けることなく、クリックするだけで接続できます。

以前 claude mcp add でサーバーを追加していた場合は、先に削除してください（claude mcp remove tako-mcp）。そうしないと、各ツールが重複して登録されます。

以前のバージョンのプラグインから更新しますか？ 以前のリリースでは、プラグイン設定に Tako API キーを指定する必要がありましたが、この設定は廃止されました。そのため、更新後の接続は何も通知されず匿名プランに切り替わります（tako_search は実行できますが、ほかの機能ではサインインが求められます）。エラーは表示されませんが、アカウントの利用上限は適用されなくなります。完全な認証済みアクセスに戻すには、/mcp → tako → Authenticate を一度実行してください（または Claude.ai の接続ボタンを使用してください）。

または、MCP サーバーを直接追加します（その後、/mcp → tako → Authenticate から、その場で認証できます）。

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

claude mcp list（tako が接続済みと表示されるはずです）またはセッション内の /mcp で確認してください。

上のワンクリックバッジを使うか、~/.cursor/mcp.json に追加してください。Cursor は初回使用時にサインインを求めます。

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

Windsurf の MCP 設定に追加してください。Windsurf は初回使用時にサインインを求めます。

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

.vscode/mcp.json（ワークスペース）またはユーザーの mcp.json に追加してください。VS Code は初回使用時にサインインを求めます。

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

**拡張機能（推奨）**はワンコマンドでインストールでき、API キーの発行や管理も不要で、すぐに無料プランで利用できます。

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

これにより、MCP 接続、Tako に同梱されている検索・調査スキル、および次の 3 つのコマンドがインストールされます。

すべてのツールとご自身のアカウント制限を利用するには、Gemini CLI 内で /mcp auth tako を実行して、一度認証してください。ブラウザーが開き、Tako アカウントでサインインできます。ホストごとの API キーは自動的に発行されます（tako.com/console/api-keys で確認・取り消しが可能です）。

手動設定：拡張機能をインストールしたくない場合や、?tools= 許可リストを指定する場合は、~/.gemini/settings.json に追加してください（後から /mcp auth tako で認証できます）。

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

代わりに API キーを使うには、"Authorization": "Bearer <key>" を含む headers ブロックを追加します。ただし、値を完全に入力してください。Gemini は未設定の ${VAR} 参照をそのまま文字列として置き換え、形式が正しくない Authorization ヘッダーは無視されずに拒否されます。そのため、トークンがまったくない場合なら接続できたところで、値が不完全なトークンが接続を妨げます。

opencode.json に追加してください。OpenCode は初回利用時にサインインを求めます。

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

Codex は mcp-remote ブリッジを通じてリモートサーバーに接続します。初回接続時に、ブラウザーでサインインのフローが実行されます。

[mcp_servers.tako]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.tako.com/mcp"]

Zed の settings.json に追加してください（mcp-remote ブリッジを通じて接続します。初回接続時に、ブラウザーでサインインのフローが実行されます）。

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

一般向けチャットホストでは Bearer トークンを受け付けていません。claude_desktop_config.json で検証されるのは stdio サーバーのみのため、リモートの "type": "http" エントリはそこで何も通知されずに無視されます。Claude Desktop は Claude.ai などと同様にコネクター経由で接続します。ホストされているエンドポイントでは OAuth 2.1 フローが実行され、Tako アカウントでサインインすると、ホストごとのキーが自動的に発行されます。

前提条件： 認証に使うアカウントで tako.com にサインインしてください。トークンをご自身で発行する必要はありません。同意フローでホストごとのキー（MCP: <client> という名前）が作成されます（tako.com/console/api-keys で確認・取り消しが可能です）。新しいホストを接続しても、別のホストのキーが再発行されることはありません。Tako は MCP キーが 10 個を超えると、最も古いものを削除します。

Claude.ai (Pro、Max、Team、または Enterprise が必要です)

1. Claude.ai を開き → Settings → Connectors
2. Add custom connector をクリックします
3. https://mcp.tako.com/mcp を貼り付けて、Connect をクリックします
4. Tako のサインインフローを完了すると、Tako が接続済みとして表示されます

Claude Desktop (Claude.ai と同じプラン要件です)

1. Claude Desktop を開き → Settings → Connectors
2. Add custom connector をクリックします
3. https://mcp.tako.com/mcp を貼り付けて、Connect をクリックします
4. Tako のサインインフローを完了すると、Tako が接続済みとして表示されます

ChatGPT — ChatGPT のアプリディレクトリから Tako アプリをインストールしてください（OAuth 経由で接続し、https://mcp.tako.com/mcp/chatgpt のアプリ用エンドポイントを使います）。代わりにカスタムコネクターとして手動で追加する場合 (Pro、Business、または Enterprise が必要です。Developer Mode を有効にしてください)：

1. ChatGPT を開き → Settings → Connectors → Developer Mode を選択して有効にします
2. Create custom connector をクリックします
3. https://mcp.tako.com/mcp/chatgpt を貼り付けて、Connect をクリックします
4. Tako のサインインフローを完了すると、コネクターが一覧に表示され、使用できるようになります /mcp/chatgpt のエンドポイントは OAuth 専用で、ChatGPT 向けに最適化されています（インタラクティブなチャートウィジェット、固定の 7 ツール一覧。このエンドポイントでは ?tools= は無視されます）。汎用の /mcp URL も使用できます。initialize で MCP Apps のサポートを宣言するクライアントにはチャートウィジェットを、それ以外のクライアントにはチャート画像を送信します。

接続時は、ホストに関係なく、Tako がホストする 3 つの画面が表示されます。サインインページ（Google、または Tako のメールアドレスとパスワード）、同意ページ（「[host] を Tako に接続 — 許可／キャンセル」）、その後ホストに戻ります。ホスト側でも同意を求める画面が表示される場合がありますが、正常な動作です。

切断。 ホストごとに切断すると（ホストの設定でコネクターを削除すると）、そのホストのみが切断されます。他のホストと Bearer 認証のクライアントは引き続き動作します。すべてを完全に停止するには、tako.com/console/api-keys でキーをローテーションしてください。すべてのホストで、以前に発行されたすべての許可が直ちに認証できなくなります。

2 つのツールを 1 ステップずつ使います。tako_search で検索し、tako_contents で取得します。

• 幅広い質問や複数の要素を含む質問 → 絞り込んだ検索を並列実行します。 単一のエンティティと指標を組み合わせたクエリに分解して同時に実行します。例：「米国の CPI インフレ率」、「米国のコア CPI インフレ率」、「米国の PCE インフレ率」。その後、自分で結果を統合します。
• Tako が何をカバーしているかについての質問 → tako_available_data を使います。 指標の正確な名前が返されます。そこで見つからなくても、ウェブ検索は引き続き利用できます。

具体的な質問 → 検索してから行データを取得する：

1. ユーザーの質問：「2024 年の米国の GDP はいくらでしたか？」
2. エージェントが tako_search を呼び出します。最上位のカードに主要な値とグラフが含まれます。
3. 系列データを取得するには、エージェントがそのカードの URL に対して tako_contents を呼び出し、グラフをインラインで表示して回答します。

作業用のデータを取得する → tako_search を並列実行する（自分で結果を統合）：

1. ユーザーの質問：「米国の CPI、コア CPI、PCE、コア PCE のインフレ率を比較してください。」
2. エージェントが、エンティティと指標の組み合わせごとに 1 つずつ、絞り込んだ tako_search 呼び出しを4 回同時に実行します。
3. それぞれの呼び出しから、主要な値を含むカードが返されます（ChatGPT アプリと MCP Apps のサポートを宣言しているその他のホストでは、各カードがグラフとして描画されます。それ以外の場所では、最初のカードのグラフ画像が描画されます）。
4. エージェントが 4 つの結果を統合し、すべての行データが必要な場合はカードの url に対して tako_contents を呼び出します（カードが exportable: true の場合）。

以下のブロックをコピーして Claude Code に貼り付けてください。MCP 接続とスキルが設定されます。

Step 1: Install or update Tako MCP

If Tako MCP already exists in your config, update it to this endpoint. Run this in your terminal:

claude mcp add tako-mcp --transport http "https://mcp.tako.com/mcp?tools=search,available_data,contents,graph_related,agent,company_agent,visualize" --header "Authorization: Bearer $TAKO_API_TOKEN"


Step 2: Add this Claude skill

---
name: tako-search
description: >-
  Use when you need to look something up: current events, facts, figures, or pages on any topic. Also use it when the answer needs a calculation over real-world data. Tako searches the web and a knowledge graph of licensed data in one call, and returns web results, plus a structured, cited card when the graph has one.
---

# Tako

Tako searches the web and a knowledge graph of licensed and public data in one call. The graph covers companies, business professionals, markets, economies, sports, weather, prediction markets, websites, and more, and refreshes much of it during the day. When the graph has the answer, the result leads with a card: a headline value, its source, and a chart. Every search also returns web results. All tools below live on the Tako MCP server installed in Step 1.

## Look something up

1. Search first. Call `tako_search` once per question, naming the entity and what you want: "Apple revenue", "Lakers last game score", "US CPI inflation", "EU AI Act timeline". For a comparison, name both entities in one query: "Nvidia vs AMD gross margin". Run independent searches in parallel.
2. Query website traffic by domain: "netflix.com monthly visits", not "Netflix website visits".
3. If a card comes back, check that it answers the question: the same entity, metric, and unit. For example, operating income isn't operating margin. Read the value from the card's `description`. To compute something from the card's rows, such as a growth rate, an average, or a correlation, follow **Compute over a series**.
4. If no card answers the question, answer from the web results. To read a page in full, pass its url to `tako_contents`.
5. If a name is ambiguous, such as "Costco" or "Coca-Cola", and the question doesn't settle which entity, ask before quoting a number.

If the user asks for Tako's agent and the `tako-agent` skill is installed, follow `tako-agent` instead.

## Find professionals and companies

`tako_search` finds business professionals and companies for B2B research, prospecting, and recruiting, and returns them as a list card. Each row is one professional or company, with their title, employer, location, LinkedIn, and a `tako_url` to their own page. Use it when the user wants the professionals or companies themselves: a list of prospects or candidates, or the professional record of someone they name.

**Professionals by role and place.** Name who and where.

- Who: a role or title ("engineers", "CFO", "VPs of sales", "head of marketing", "founders", "interns"), or a word for a company's people ("employees", "staff", "leadership team"). "Executives", "leadership", and "management" return C-suite and VP-level people.
- Where: an employer, a place, or both: "engineers at Stripe", "CFOs in Austin", "engineers at Google in London". A place needs a role, so "people in Austin" returns no list. A role alone ("CFOs") and an employer alone ("Stripe") also return no list.
- To find who holds a role at one company, search the role and the company: "Airbnb CFO" or "who is the CFO of Airbnb".
- Give a city its state or country: "engineers in Portland, OR". A bare city name matches every place with that name.

**A professional by name.** Search the full name alone, such as "Jane Doe". The list holds everyone with that name.

- Leave out everything else the user told you, such as the employer or title. Search reads every word as part of the name, so "Jane Doe Stripe" returns no list. Use those details to pick the person from the rows.
- Search doesn't match nicknames: "Tim Cook" and "Timothy Cook" return different people. If no row fits, try the other form of the name.
- A common name can match hundreds of people, and the rows can't be filtered by employer. If the person isn't in the first rows, fetch more and match on employer, title, and location.

**Companies by industry or type**, plus a place, a size, a funding stage, public or private, or a founding year: "fintechs in London", "SaaS companies with 50–500 employees", "Series B startups in Berlin", "AI startups founded since 2020".

Then read the list:

1. The card's `description` doesn't name the matches. To see them, pass the card's url to `tako_contents` with `max_rows` set to the rows the answer needs, such as 25. Fetch the full list, up to 1,000 rows, only when the user asks for it.
2. Check each row before you use it. A name list holds everyone with that name, and a company name can match more than one company. If more than one row fits the person the user means, ask which one.
3. Each row's `tako_url` opens that one person or company in Tako. Link it.
4. Tako withholds premium cells, such as business contact fields. A list card shows each one as 🔒, and the result's `note` names the withheld columns. Don't tell the user that a withheld field is empty. When the user asks for those fields, call `tako_contents` again with `premium: true`, and set `offset` and `max_rows` to only the rows they want, because Tako bills each of those rows. The row order can change between calls, so check the name on each row you get. After a `premium: true` call, the card's page shows those cells to anyone who opens it, so don't link that card unless the user wants to share them.
5. A list can't filter on revenue, investors, registry status, or a company's officers and directors. If the question needs one of those, say so. If the `tako-agent` skill is installed, offer Tako's company agent.
6. If no list card comes back, tell the user that Tako found no list. If the `tako-agent` skill is installed, offer Tako's company agent.

## Compute over a series

Compute in code, never in your head: growth rates, averages, CAGR, correlations, and rankings. Report what the code prints. Only a card marked `exportable: true` has rows to fetch.

1. **If you can run shell commands**, call `tako_contents` with `delivery: "link"`, then download the file right away: `curl -sfL -o <name>.csv "<url>"`. The link expires 5 minutes after the call. Analyze the file in a script and read only the result, so the rows never enter your context. If the result says `truncated`, call again with a higher `max_rows`, up to 100,000.
2. **If the download fails**, your shell may have no network access. Call `tako_contents` again without `delivery`, with `max_rows` at 2,000 or less, and pass the inline rows to your code tool.
3. **If you have no shell**, or `tako_contents` has no `delivery` input, fetch the rows inline and pass them to your code tool. With no code tool at all, show each step of the arithmetic so the user can check it.
4. **If `tako_contents` has a `format` input**, set `format: "card"` for a card's own structure, such as a company card's tabs.

## Explore what Tako has

For questions about coverage or relationships, such as "What does Tako track for Tesla?", "Who competes with Nvidia?", or "Which countries are in the G7?", resolve the entity with `tako_available_data`. Then call `tako_graph_related` on the node id it returns.

## Report

- Lead with the answer in one or two lines. The top card renders inline as a chart, so refer to it in prose; don't re-post its image URL.
- Name the source: the card's `source`, or the web page you used.
- Link the card you used: `[Open in Tako](url)`.
- If the series ended well before today, give its as-of date from `coverage_end`.

Step 3: Ask the user to restart Claude Code

Ask the user to restart Claude Code so the config change takes effect.

以下のブロックをコピーして Claude Code に貼り付けてください。MCP 接続とスキルが設定されます。

Step 1: Install or update Tako MCP

If Tako MCP already exists in your config, update it to this endpoint. Run this in your terminal:

claude mcp add tako-mcp --transport http "https://mcp.tako.com/mcp?tools=search,available_data,contents,graph_related,agent,company_agent,visualize" --header "Authorization: Bearer $TAKO_API_TOKEN"


Step 2: Add this Claude skill

---
name: tako-agent
description: >-
  Use when the user explicitly asks for Tako's research agent or for deep, multi-step research with Tako, such as "use the Tako agent to…", "have Tako research…", or "use Tako's company agent to…". Tako's agents plan the steps, search the web and licensed data, and return a cited answer with charts or lists. For any other question, use tako-search, even one that needs a ranking or a calculation.
---

# Tako agents

Tako's agents run multi-step research. An agent plans its own steps, searches the web and Tako's licensed data, computes what the question asks for, and returns a cited answer with charts or lists. All tools below live on the Tako MCP server installed in Step 1.

## When to use an agent

Start an agent only when the user asks for one: they name Tako's agent or ask for deep or multi-step research with Tako. Otherwise, use `tako-search`, even when the question needs a ranking, a trend, a calculation, or a list of companies or professionals. Don't start an agent for a task that needs no data, such as writing, editing, or explaining a concept.

## Choose the agent

- Use `tako_company_agent` when the user names the Company Agent or wants a list of companies or of the professionals at them: companies by location, industry, status, founding date, funding, or size, or the officers, directors, executives, or employees of those companies.
- Use `tako_agent` for anything else, such as a chart, a written finding, or a ranking of companies by a metric.

## Run an agent

1. Send the user's question in `query`, one question per call. The agent plans its own steps, so don't split the question.
2. If `status` is `running`, call the same tool again with that `run_id` and no `query`. Don't start a new run for the same question.
3. If a call fails before it returns a `run_id`, follow its guidance. If the guidance says the run may have started, ask the user before you retry.
4. For a follow-up in the same conversation, pass the `thread_id` from the earlier run with the new `query`.

## Effort

`tako_company_agent` takes `effort`. Leave it unset for the default, `medium`. Use `high` only when the user asks for a thorough answer. Don't use `low` when the question filters by a financial metric such as revenue or headcount, because `low` can't. A thread keeps its effort, so omit `effort` on a follow-up.

## Report

- Lead with the agent's answer in a few lines, and keep its numbered citations.
- Link each card the agent returns: `[Open in Tako](url)`. The full chart or list lives on that page.
- If the agent says it couldn't answer part of the question, say so.

Step 3: Ask the user to restart Claude Code

Ask the user to restart Claude Code so the config change takes effect.

• ツールの構成を、デフォルトの小規模な一覧と ?tools= によるオプトインに再編し、?tools= のグループ別エイリアス（graph、credits、answer、visualize、agent）を導入しました。エイリアスと一部のツールはすでに削除されています。現在の構成については、上記の項目と docs/TOOLS.md をご覧ください。
• チャート画像（get_chart_image）、インタラクティブチャート（open_chart_ui）、チャート作成（create_chart）、レポート（create_report、get_report、list_reports、export_report）の各ツールを削除しました。
• セルフホスト可能な Python サーバー（pip install tako-mcp / Docker）を削除し、ホスト型の Cloudflare Worker に移行しました。

古いツール名や Python SSE エンドポイントを参照しているクライアント設定やエージェントのプロンプトを更新してください。

Tako は、リモートサーバーとして io.github.TakoData/tako-mcp の名前で公式の MCP Registry に公開されています。

• server.json（リポジトリのルート）はレジストリ記述子です。https://mcp.tako.com/mcp を指すリモートの streamable-http エントリーです。スキーマにはツールが記載されていません。ホストは実行時に tools/list を通じてツールを検出します。（npm run registry:gen / registry:check で使用する、リポジトリ内で生成されたツールカタログ registry/server.json とは別のものです。）
• 公開は .github/workflows/publish-mcp.yml によって自動化されており、認証にはGitHub OIDCを使用します（シークレットは不要です）。バージョンはコード内で管理されています。server.json の version を更新して main にマージすると、自動的に公開されます。バージョンが変わらないマージでは何も行われません。
• **ブランド付き名前空間（com.tako/tako-mcp）**への移行は、DNS 認証（Ed25519 キーと tako.com の TXT レコード）が必要な将来のアップグレードです。
• バージョン管理と変更履歴は release-please で自動化されています。貢献者は Conventional Commit 形式の PR タイトルを使用します（スカッシュマージ）。メンテナーは、ボットが作成した release: X.Y.Z PR をマージしてリリースを行います。AGENTS.md → Releases をご覧ください。