TILLA - market data on one clock

TILLA MCP サーバー

クオンツと AI 向けに整合された市場データ：暗号資産、株式、FX、マクロを同じ時計で取得し、AI エージェントに直接提供します。

3,854	280,675	45 · 33 · 44 · 23	1分足から四半期足まで
生データポイント	先読みなしの指標	暗号資産 · 米国株式／ETF · FX · 現物 ETF	2017年からの時間足履歴

TILLA は、暗号資産の現物およびデリバティブ、米国株式と ETF、FX、金利、マクロデータ、すべてのビットコインおよびイーサの現物 ETF（ファンドごと）、さらに独自のビットコインノードからのブロック、メンプール、手数料を提供します。すべての値は同じ UTC の時計に基づいています。

これは公式の Model Context Protocol サーバーです。Claude、Cursor、その他すべての MCP クライアント向けに、読み取り専用のツールを14個提供します。無料キー、カード不要。または、ホスト型サーバー https://mcp.tillacrypto.com/mcp を使えば、インストールも不要です。

• サイト：https://tillacrypto.com · ドキュメント：https://tillacrypto.com/docs · プランと無料サンプル：https://tillacrypto.com/pricing
• エージェントには、「今月の BTC 価格と現物 ETF のフローを比較して」 や 「NVDA と BTC を1つの時間足チャートに表示して」 などと尋ねてみてください。

30秒で接続

1. https://tillacrypto.com で無料 API キーを取得します（カード不要）。または POST https://api.tillacrypto.com/v1/demo_key を使うと、アカウントなしでキーを取得できます。
2. MCP クライアントにサーバーを追加します。

Claude Desktop / Claude Code / Cursor（ローカル、stdio）

pip install tilla-mcp

{
  "mcpServers": {
    "tilla": {
      "command": "tilla-mcp",
      "env": { "TILLA_API_KEY": "tk_live_your_key_here" }
    }
  }
}

uv を使えばインストールは不要です："command": "uvx", "args": ["tilla-mcp"]。または、このフォルダーのファイルを直接実行します： pip install "mcp>=1.9,<2" httpx を実行してから、"command": "python", "args": ["/path/to/tilla_mcp.py"] を指定します。

ホスト型 - インストール不要

https://mcp.tillacrypto.com/mcp（ストリーミング可能な HTTP）。呼び出し元はそれぞれ自身のキーを送信します：X-API-Key: <key>、または Authorization: Bearer <key>、または URL の ?key=<key>。キーがなくても、無料ツールは引き続き利用できます。

{ "mcpServers": { "tilla": { "url": "https://mcp.tillacrypto.com/mcp", "headers": { "X-API-Key": "tk_live_..." } } } }

HTTP で独自に実行

TILLA_MCP_TRANSPORT=http python tilla_mcp.py
# serves MCP over http://127.0.0.1:8971/mcp; each request carries its own key as above

ツール

すべてのツールは API の実際のルートを呼び出します（tilla_mcp.py の TOOL_ROUTES にその名前が記載されています）。

ツール	キー？	機能	API 呼び出し
tilla_about	いいえ	TILLA の概要と利用開始方法	-
tilla_status	いいえ	最新の1分足と提供されるティア	GET /v1/status
tilla_tiers	いいえ	公開プラン：価格、履歴上限、制限、サイズ	GET /v1/tiers
tilla_inventory	はい	キーが利用できる系列をレイヤーおよびレーンごとに正確に表示します（最初に呼び出してください）	GET /v1/inventory
tilla_latest	はい	1つのレーンにある、指定した系列の最新足	GET /v1/<tier>/<layer>/<lane>
tilla_window	はい	足の範囲を取得します。more が true の間は next_start を使ってページングします	GET /v1/<tier>/<layer>/<lane>
tilla_usage	はい	キーのプランと現在の利用枠	GET /v1/usage
tilla_markets	いいえ	すべての市場、そのカテゴリ、関連市場	GET /v1/markets
tilla_market	はい	1つの市場（および任意でその関連市場）を同じ時計で表示します	GET /v1/<tier>/market/<id>
tilla_sample	いいえ	プランの無料サンプル：レーンごとの系列と実データ1行	GET /v1/sample/<tier>
tilla_health	いいえ	すべてのレーンの最新足を表示し、データが最新か確認します	GET /v1/health
tilla_docs	いいえ	API マニュアル全体を1回の呼び出しで取得します	GET /llms-full.txt + GET /v1
tilla_tick	はい	キーが利用できるすべての系列について、直近に確定した足のデータを1回の呼び出しで取得します	GET /v1/<tier>/tick
tilla_changes	はい	指定した時刻以降に修正されたすべての値を取得し、保存済みのコピーを最新の状態に保ちます	GET /v1/<tier>/changes

リソース：tilla://about、tilla://tiers。

設定（env）

変数	デフォルト	説明
TILLA_API_KEY	-	tk_live_... キー（キーが必要なツールで必要）
TILLA_API_BASE	https://api.tillacrypto.com	API のベース URL（開発用：http://127.0.0.1:8898）
TILLA_MCP_TRANSPORT	stdio	stdio（ローカル）または http（リモート）
TILLA_MCP_HOST / TILLA_MCP_PORT	127.0.0.1 / 8971	HTTP のバインド先

設計上の安全性

• 読み取り専用： すべてのツールは api.tillacrypto.com（ドキュメントについては tillacrypto.com）への HTTPS GET です。ファイルへの書き込み、コマンドの実行、取引の発注、ウォレットへのアクセスを行うツールはありません。
• API キーは TILLA_API_KEY から読み込まれ、TILLA API にのみ送信されます。ログに記録されたり、エージェントに返されたりすることはありません。
• HTTP モードは、 TILLA_MCP_HOST を自分で設定しない限り、127.0.0.1 にバインドされます。
• **依存関係は 2 つで、**どちらも標準的なものです。公式の mcp SDK と httpx です。

エージェント向けの注意事項

• 系列名を指定する前に tilla_inventory を呼び出してください。系列名を推測してはいけません。
• start を指定しないウィンドウでは最新のバーが返されます。start を指定した場合は、more が false になるまで next_start を使ってページを進めてください。
• 403 はキーまたはデータがプランの対象外であることを示します。429 は分または日単位の利用上限に達したことを示し、再試行するタイミングは retry_after_seconds で確認できます。
• 空の値は実際の状態を表します。市場が閉まっている場合は最後の約定値が維持されますが、市場が開いていて約定値がない場合や、導出値に数学的な解がない場合は、値を捏造せず空のままにします。

MIT ライセンスです。データアクセスには TILLA プランの規約が適用されます。