TILLA - market data on one clock

io.github.TillaCrypto由 GitHub 帳號 TillaCrypto 發布v2.0.3更新於 Nov 5, 2026

Aligned market data for AI agents: crypto, stocks, FX and macro on one clock. Local or hosted.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

TILLA 讓助理以唯讀方式取得對齊同一 UTC 時鐘的加密、美股、ETF、外匯與宏觀市場資料，可本機或託管執行。

可以做什麼
  • 探索市場目錄：列出所有市場及其分類與關聯市場，並查看方案、層級與免費樣本
  • 檢查資料新鮮度：最新 1 分鐘 K 線、各 lane 健康狀態，以及指定序列的最新 K 線
  • 讀取序列資料：金鑰可存取的序列清單、最新 K 線，以及依名稱或樣式分頁取得的區間 K 線
  • 一次取得整個市場，可選擇包含其關聯市場，並指定時間範圍
  • 取得剛收盤那一分鐘的整份方案 tick、自某時間起被修正的數值，以及目前用量與額度
  • 一次呼叫讀取完整 API 手冊與伺服器說明
適用情境
適合需要跨加密、股票、外匯與宏觀、且基於統一時鐘的量化市場背景，例如比較 BTC 價格與現貨 ETF 資金流，或把 NVDA 與 BTC 放在同一張圖上。免費工具也可在申請金鑰前先瀏覽目錄與樣本資料。
執行需求
可使用託管的 streamable HTTP 端點，或透過 pip、uvx 本機安裝（Python，依賴 mcp SDK 與 httpx）。需要金鑰的工具要求 TILLA API 金鑰：本機用 TILLA_API_KEY，託管用 X-API-Key 標頭；可免費申請。需要能存取 TILLA API 的網路。
安裝前請注意
API 金鑰屬於憑證：應放在 TILLA_API_KEY 或 X-API-Key 標頭中，避免寫入可能被記錄的 URL。需要金鑰的工具會消耗方案請求額度，403 或 429 表示資料超出方案或觸及限額。所有工具皆為唯讀，不會交易或接觸錢包，但查詢內容與金鑰會傳送給第三方 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 TILLA - market data on one clock，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.TillaCrypto%2Ftilla-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tilla-market-data-on-one-clock": {
      "type": "http",
      "url": "https://mcp.tillacrypto.com/mcp"
    }
  }
}

README

TILLA MCP server

Aligned market data for quants and AI: crypto, stocks, FX and macro on one clock - straight into your AI agent.

3,854280,67545 · 33 · 44 · 231-minute to quarterly
raw datapointsindicators, no look-aheadcrypto · US stocks/ETFs · FX · spot ETFshourly history from 2017

TILLA serves crypto spot and derivatives, US stocks and ETFs, FX, rates, macro, every Bitcoin and Ether spot ETF fund by fund, and blocks, mempool and fees from our own Bitcoin node - every value on one UTC clock.

This is the official Model Context Protocol server: 14 read-only tools for Claude, Cursor or any MCP client. Free key, no card - or no install at all with the hosted server https://mcp.tillacrypto.com/mcp.

Connect in 30 seconds

  1. Get a free API key at https://tillacrypto.com (no card), or POST https://api.tillacrypto.com/v1/demo_key for one with no account.
  2. Add the server to your MCP client.

Claude Desktop / Claude Code / Cursor (local, stdio)

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

With uv, nothing to install: "command": "uvx", "args": ["tilla-mcp"]. Or run this folder's file directly: pip install "mcp>=1.9,<2" httpx, then "command": "python", "args": ["/path/to/tilla_mcp.py"].

Hosted - nothing to install

https://mcp.tillacrypto.com/mcp (streamable HTTP). Each caller sends their own key: X-API-Key: <key>, or Authorization: Bearer <key>, or ?key=<key> on the URL. Without a key the free tools still answer.

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

Run your own over HTTP

bash
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

Tools

Every tool calls a real route of the API (TOOL_ROUTES in tilla_mcp.py names it).

ToolKey?What it doesAPI call
tilla_aboutnoWhat TILLA is and how to start-
tilla_statusnoThe newest 1-minute bar and the tiers servedGET /v1/status
tilla_tiersnoThe public plans: price, history cap, limits, sizeGET /v1/tiers
tilla_inventoryyesExactly which series the key holds, per layer and lane (call this first)GET /v1/inventory
tilla_latestyesThe newest bar of named series on one laneGET /v1/<tier>/<layer>/<lane>
tilla_windowyesA range of bars; page with next_start while more is trueGET /v1/<tier>/<layer>/<lane>
tilla_usageyesThe key's plan and budget right nowGET /v1/usage
tilla_marketsnoEvery market, its category and related marketsGET /v1/markets
tilla_marketyesOne market (and optionally its related ones) on one clockGET /v1/<tier>/market/<id>
tilla_samplenoThe free sample of a plan: series per lane + one real rowGET /v1/sample/<tier>
tilla_healthnoThe newest bar of every lane - is the data currentGET /v1/health
tilla_docsnoThe whole API manual in one callGET /llms-full.txt + GET /v1
tilla_tickyesEvery series the key holds for the bar that just closed, one callGET /v1/<tier>/tick
tilla_changesyesEvery value repaired since a time, so a kept copy stays correctGET /v1/<tier>/changes

Resources: tilla://about, tilla://tiers.

Config (env)

VarDefaultMeaning
TILLA_API_KEY-Your tk_live_... key (needed for keyed tools)
TILLA_API_BASEhttps://api.tillacrypto.comAPI base (dev: http://127.0.0.1:8898)
TILLA_MCP_TRANSPORTstdiostdio (local) or http (remote)
TILLA_MCP_HOST / TILLA_MCP_PORT127.0.0.1 / 8971HTTP bind

Safe by design

  • Read-only: every tool is an HTTPS GET to api.tillacrypto.com (or tillacrypto.com for the docs). No tool writes a file, runs a command, places a trade or touches a wallet.
  • Your key is read from TILLA_API_KEY and sent only to the TILLA API, never logged or returned to the agent.
  • HTTP mode binds to 127.0.0.1 unless you set TILLA_MCP_HOST yourself.
  • Two dependencies, both standard: the official mcp SDK and httpx.

Notes for the agent

  • Call tilla_inventory before naming a series - never guess a series name.
  • A window with no start returns the newest bars; with a start, page forward with next_start until more is false.
  • 403 means the key or the data is outside the plan; 429 means a minute or day budget was hit, and retry_after_seconds says when to try again.
  • An empty value is real: a closed market carries its last print, but an open market with no print (and a derived value with no mathematical answer) is left empty, never invented.

MIT licensed. Data access governed by the TILLA plan terms.

來源：mcp/README.md，提交 adb30ad

工具

14

tilla_about

About TILLA

What TILLA is, who it's for, and how to start. No API key needed.

無需輸入參數。

tilla_status

Feed status

The newest 1-minute bar and the tiers served. No API key needed.

無需輸入參數。

tilla_tiers

Plans and limits

The public plans: price, history cap, request limits and size. No API key needed.

無需輸入參數。

tilla_inventory

Series this key holds

Exactly what the caller's key holds. No arguments: every lane per layer with its series count. layer=raw|derived|node and lane=1min|hour|daily|...: every series name there. Call this before tilla_latest / tilla_window and use the names it returns. Needs your API key (hosted: the X-API-Key header; local: TILLA_API_KEY).

輸入參數lanelayer

tilla_window

Bars in a time range

A window of bars. Name exactly what you want, one of: `series` = comma-separated names (at most 200) from tilla_inventory, or a pattern like 'btc_*' / '*_close'; or `markets` + `fields` ('btc,eth' + 'close,volume' -> btc_close, btc_volume, eth_close, eth_volume). layer = raw | derived | node | deep; lane = 1min, 5min, hour, daily, ... start/end = 'YYYY-MM-DD[ HH:MM[:SS]]' UTC inclusive, or period = 30d 2m 6m 1y all; no start = the newest bars. limit <= 50000. When `more` is true, call again with start = `next_start`. Needs your API key (hosted: the X-API-Key header; local: TILLA_API_KEY).

輸入參數endlanelayerlimitstartfieldsperiodseriesmarkets

tilla_latest

Latest bar

The newest bar of the named series on one lane. Needs your API key (hosted: the X-API-Key header; local: TILLA_API_KEY).

輸入參數lanelayerseries必填

tilla_usage

Plan and budget

The caller's plan and budget right now: tier, history days, limits, used today. Needs your API key (hosted: the X-API-Key header; local: TILLA_API_KEY).

無需輸入參數。

tilla_markets

Every market

Every market TILLA carries - crypto, US stocks and ETFs, FX, macro - with its category, its related markets, how many series each plan holds of it, and its lanes. No API key needed. Use the `id` with tilla_market.

無需輸入參數。

tilla_market

One whole market

One market in one call: every series of `market` (an id from tilla_markets, e.g. btc, nvda, eurusd, gold) the key holds on `lane`, on one clock. layer = raw | derived | node | deep | all. related=True adds its connected markets (btc: its ETFs and miners). period = 1d 7d 30d 2m 3m 6m 1y 2y 3y all. At most 200 columns an answer: `series_next_offset` names the next page. Needs your API key (hosted: the X-API-Key header; local: TILLA_API_KEY).

輸入參數lanelayerlimitmarket必填periodrelated

tilla_sample

Free sample of a plan

The free sample of one plan (free, builder, pro or max), no key needed: how many series it holds on every lane, and one aligned 1-minute row of real values. The full one-tick files are at /v1/sample/<tier>.csv and .db (named in the answer's `files`).

輸入參數tier

tilla_health

Is every lane current

The newest bar of every lane on every layer - is the data current? No API key needed.

無需輸入參數。

tilla_docs

The API manual

The whole API manual in one call, no key needed: every call, every parameter, every plan, how paging, tick, resume, changes and bulk work. Read this first when you need to know how to do anything.

無需輸入參數。

tilla_tick

Everything that just closed

Your whole plan, live, in one call: every series the key holds on every lane that closed at a boundary (`at` = 'YYYY-MM-DD HH:MM', default the minute just closed). Per lane: bar, complete, series, values. Needs a key.

輸入參數atlanes

tilla_changes

Corrections since a time

Every value our checks repaired since `since` ('YYYY-MM-DD HH:MM:SS') that the key holds, with its value now - apply them and a kept copy stays correct. Pass the answer's `until` as the next since. Needs a key.

輸入參數since必填

版本歷史

4
  1. v2.0.3最新Nov 5, 2026
  2. v2.0.2Nov 1, 2026
  3. v2.0.1Oct 31, 2026
  4. v2.0.0Oct 31, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分