TILLA MCP server

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

TILLA serves raw venue data, derived indicators computed from it bar by bar with no look-ahead, and blocks and mempool data from our own Bitcoin node - crypto spot and derivatives, equities and ETFs, FX, rates and macro - every value on one UTC clock, every bar hashed as it lands.

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)

First pip install "mcp>=1.2,<2" httpx, then point your client at tilla_mcp.py in this folder:

{
  "mcpServers": {
    "tilla": {
      "command": "python",
      "args": ["/path/to/tilla_mcp.py"],
      "env": { "TILLA_API_KEY": "tk_live_your_key_here" }
    }
  }
}

Once tilla-mcp is published on PyPI, "command": "uvx", "args": ["tilla-mcp"] will work too, with nothing to download.

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.