tell: buying signals with receipts

tell-mcp

tell の MCP サーバーです。tell はオープンソースの購買シグナルパイプラインです。Claude Desktop、Cursor、その他の MCP クライアントから、どのアカウントが購買を検討しているか、その理由を問い合わせられます。すべてのシグナルには、根拠となる URL（求人掲示板、SEC Form D の提出書類、ニュース記事など）が付いています。stdio 経由でローカル実行し、tell の公開静的 JSON を読み込みます。キーもアカウントも不要です。

クイックスタート

uvx tell-mcp --help

Claude Desktop（claude_desktop_config.json）または Cursor（~/.cursor/mcp.json）の場合：

{
  "mcpServers": {
    "tell": {
      "command": "uvx",
      "args": ["tell-mcp"],
      "env": { "TELL_BASE_URL": "https://karank2512.github.io/tell-data" }
    }
  }
}

アプリを再起動して、「この 10 個のドメインのうち、購買を検討しているのはどれですか？その理由は？」と尋ねます。

ツール

ツール	入力	出力
watch_accounts	domains、watchlist	v0：ドメインを事前入力した登録フォームへのリンク。ウォッチリストは夜間ジョブの実行後に表示されます
in_market	watchlist、since_days（7）、min_score（6.0）、families	[{domain, name, score, heat, top_contributions[:3]}]。スコアの高い順
explain	domain	根拠 URL を含むすべての寄与要因と、「スコアがこれ以上高くない理由」（過去 30 日間に減衰したシグナル）
events	domain、since、types	寄与要因と集計対象の求人情報を新しい順に最大 200 件。それぞれに URL が付きます
coverage	domains	ドメインごとの求人掲示板、SEC CIK、ニュースフィード、または「監視対象外」

プロンプト why_now_email(domain)：上位 2 件のシグナルと根拠 URL をもとに、アウトリーチメール用の「今である理由」を 2 文で作成します。ツールの説明では、エージェントに、言及する各シグナルの url を引用し、アウトリーチ文面を作成する前に explain を呼び出すよう求めます。

設定

変数	デフォルト	意味
TELL_BASE_URL	https://karank2512.github.io/tell-data	読み込む静的サイト
TELL_API_KEY、TELL_API_URL	未設定	両方を設定すると、FastAPI サービスから Bearer キーを使って企業とウォッチリストを読み込みます
TELL_INTAKE_FORM_URL	未設定	watch_accounts 用の登録フォーム（デフォルトはリポジトリの「Watch these domains」課題フォーム）

v0 の制限事項

• watch_accounts は事前入力済みのリンクを返します。ウォッチリストは作成しません。
• in_market が読み込むのは公開ウォッチリストのみです（api/v0/watchlists/{slug}.json）。
• events は読み込み可能な未加工イベントのエンドポイントを持ちません。スコアに反映された寄与要因と、その根拠となる集計対象の求人情報を一覧表示します。
• データは取り込み実行ごと（1 日 4 回）に更新されます。180 日間動きのないドメインにはファイルがなく、「監視対象外」として扱われます。

FastAPI サービスのデプロイ後、TELL_API_KEY と TELL_API_URL を設定すると、ほかの変更を加えずに企業とウォッチリストの読み込み先が切り替わります。

ドキュメント全文：docs/mcp.md。
ライセンス：Apache-2.0。