Stocktwits

@pipeworx/stocktwits

StockTwits MCP — 株式に特化したソーシャルセンチメントです。キー不要の読み取りエンドポイントで、IP あたり毎時 200 リクエストです。

Pipeworx の一部です — AI エージェントを 1715 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携・承認・公開のいずれも行っていません。

ツール

• symbol_stream(symbol, since?, max?, limit?, filter?) — ティッカーに言及しているメッセージ
• user_stream(user_id, since?, max?, limit?) — ユーザーからのメッセージ
• trending_symbols(limit?) — トレンド上位のティッカー
• trending_messages(limit?) — トレンドのメッセージ
• suggested_symbols(limit?) — 編集部おすすめ
• symbol_search(q, limit?) — シンボル検索
• chart_data(symbol, period?) — ティッカーの OHLCV 価格バー。period は 1D（デフォルト、5 分足）、1W、1M、3M、6M、YTD、1Y、5Y、ALL のいずれかです
• watchlists(user_id) — ユーザーのウォッチリスト
• watchlist(watchlist_id, since?, max?, limit?) — ウォッチリストからのメッセージ

注意事項

StockTwits の公開読み取りエンドポイントはキー不要ですが、レート制限があります（IP あたり毎時 200 リクエスト）。ゲートウェイの送信 IP は共有されているため、頻繁に利用するとスロットリングされる場合があります。その場合、上流は 429 を返し、このパックはその応答を適切に通知します。

データソース

ストリーム、トレンド、検索、ウォッチリストには https://api.stocktwits.com/api/2 を、chart_data には https://ql.stocktwits.com/chart（stocktwits.com の背後でチャートデータを提供するフィード）を使用します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "stocktwits": {
      "url": "https://gateway.pipeworx.io/stocktwits/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/stocktwits/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツールの ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共有ツールが約 30 個表示されます。接続の initialize 応答に正確な範囲が記載されており、その日の情報として正式なものです。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックで対応していない質問にも対応できます。ask_pipeworx がカタログ全体からルーティングするため、2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックエンドポイントに接続する代わりに、ゲートウェイ全体に一度だけ接続してください。

また、以下のように Pipeworx ゲートウェイ全体に接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1715 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/symbol_stream \
  -H 'Content-Type: application/json' \
  -d '{"symbol":"TSLA"}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/symbol_stream を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイを経由する通信も不要です：

{
  "mcpServers": {
    "stocktwits": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-stocktwits"]
    }
  }
}

または、直接実行して起動することを確認できます：

npx -y @pipeworx/mcp-stocktwits

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールだけで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます：

ask_pipeworx({ question: "your question about Stocktwits data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT