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 分