TILLA MCP server

Let your AI agent pull TILLA's market data directly.

TILLA serves crypto spot and derivatives, US stocks and ETFs, FX, rates, macro, fund-by-fund Bitcoin and Ether spot ETF flows and blocks and mempool data from our own Bitcoin node - every value on one UTC clock - plus 293,743 indicators computed bar by bar with no look-ahead.

This is the official Model Context Protocol server. Add it to any MCP client and your agent can query TILLA on its own.

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

{
  "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"].

Remote / hosted (streamable HTTP)

TILLA_MCP_TRANSPORT=http TILLA_API_KEY=tk_live_... python tilla_mcp.py
# serves MCP over http://127.0.0.1:8971/mcp  (front with TLS for a public connector)

Tools

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

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

Config (env)

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.