TILLA - market data on one clock

TILLA MCP 服务

为量化研究人员和 AI 提供对齐的市场数据：加密货币、股票、外汇和宏观数据共用一个时钟，直接接入 AI Agent。

3,854	280,675	45 · 33 · 44 · 23	1 分钟至季度
原始数据点	指标，不存在前视偏差	加密货币 · 美国股票/ETF · 外汇 · 现货 ETF	自 2017 年起的小时级历史数据

TILLA 提供加密货币现货和衍生品、美国股票和 ETF、外汇、利率、宏观数据、每一只 Bitcoin 和 Ether 现货 ETF 的基金级数据，以及来自我们自有 Bitcoin 节点的区块、内存池和费用数据——所有数值均使用同一个 UTC 时钟。

这是官方 Model Context Protocol 服务：为 Claude、Cursor 或任何 MCP 客户端提供 14 个只读工具。免费密钥，无需信用卡——也可以完全无需安装，直接使用托管服务 https://mcp.tillacrypto.com/mcp。

• 网站：https://tillacrypto.com · 文档：https://tillacrypto.com/docs · 套餐和免费样例：https://tillacrypto.com/pricing
• 可以向你的 Agent 询问诸如 “本月 BTC 价格与现货 ETF 资金流对比” 或 “在同一张小时图表上查看 NVDA 和 BTC” 等问题。

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 分钟 K 线和所提供的数据层级	GET /v1/status
tilla_tiers	否	公开套餐：价格、历史数据上限、限制、规模	GET /v1/tiers
tilla_inventory	是	密钥持有的具体数据系列，按数据层和数据通道划分（请先调用此工具）	GET /v1/inventory
tilla_latest	是	指定数据通道上指定数据系列的最新 K 线	GET /v1/<tier>/<layer>/<lane>
tilla_window	是	一段时间范围内的 K 线；当 more 为 true 时，使用 next_start 翻页	GET /v1/<tier>/<layer>/<lane>
tilla_usage	是	当前密钥的套餐和使用额度	GET /v1/usage
tilla_markets	否	所有市场、市场类别及相关市场	GET /v1/markets
tilla_market	是	在同一个时钟上查看单个市场（以及可选的相关市场）	GET /v1/<tier>/market/<id>
tilla_sample	否	套餐的免费样例：每个数据通道的数据系列和一条真实数据记录	GET /v1/sample/<tier>
tilla_health	否	每个数据通道的最新 K 线——数据是否为最新	GET /v1/health
tilla_docs	否	一次调用获取完整 API 手册	GET /llms-full.txt + GET /v1
tilla_tick	是	一次调用获取密钥持有的所有数据系列在刚收盘 K 线对应的数据	GET /v1/<tier>/tick
tilla_changes	是	获取某个时间点之后修正的所有数值，确保保留的副本仍然准确	GET /v1/<tier>/changes

资源：tilla://about、tilla://tiers。

配置（环境变量）

变量	默认值	说明
TILLA_API_KEY	-	你的 tk_live_... 密钥（使用需要密钥的工具时必需）
TILLA_API_BASE	https://api.tillacrypto.com	API 基础地址（开发环境：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 请求。没有工具会写入文件、运行命令、下单交易或访问钱包。
• 你的密钥从 TILLA_API_KEY 读取，且只发送到 TILLA API，绝不会记录日志或返回给 Agent。
• HTTP 模式绑定到 127.0.0.1，除非你自行设置 TILLA_MCP_HOST。
• **仅有两个依赖，**且都是标准依赖：官方 mcp SDK 和 httpx。

给 Agent 的说明

• 命名序列前先调用 tilla_inventory——绝不要猜测序列名称。
• 未提供 start 的时间窗口会返回最新的 bar；提供 start 后，使用 next_start 向后翻页，直到 more 为 false。
• 403 表示密钥或数据不在计划范围内；429 表示已达到每分钟或每日限额，retry_after_seconds 会说明何时可以重试。
• 空值确有其意：休市市场会保留最后一次报价，但开市市场若没有报价（或衍生值没有数学解），则会留空，绝不编造。

采用 MIT 许可。数据访问受 TILLA 计划条款约束。