English Français العربية

TILLA - market data on one clock

Official registry Finance and payments

Crypto, US stocks, FX, rates, macro and Bitcoin node data on one clock, for any AI agent.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package tilla-mcp
Claude Code 
claude mcp add tilla-market-data-on-one-clock -e 'TILLA_API_KEY=<your tilla_api_key>' -e 'TILLA_API_BASE=<TILLA_API_BASE>' -- uvx tilla-mcp==2.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tilla-market-data-on-one-clock": {
            "command": "uvx",
            "args": [
                "tilla-mcp==2.0.1"
            ],
            "env": {
                "TILLA_API_KEY": "<your tilla_api_key>",
                "TILLA_API_BASE": "<TILLA_API_BASE>"
            }
        }
    }
}

Environment variables

  • TILLA_API_KEY required secret Your TILLA API key (tk_live_...). Get a free one at https://tillacrypto.com
  • TILLA_API_BASE API base URL. Defaults to https://api.tillacrypto.com

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TILLA
  2. In your AI agent (MCP)
  3. A key and a first call
  4. What's in here
  5. The three calls behind it
  6. Safe to run
  7. License
  8. Contact

TILLA

Market data for trading models, bots and AI agents. Crypto, US stocks and ETFs, FX, rates and macro on one UTC clock, from 1-minute bars to quarterly.

  • Every market lines up. BTC, NVDA, EUR/USD, the 10-year yield and VIX share the same timestamp. No joins, no drift.
  • Bitcoin and Ether spot ETF flows, fund by fund, daily, next to price, funding and open interest.
  • 293,743 derived indicators, computed bar by bar with no look-ahead.
  • Our own Bitcoin node: blocks, mempool and fees on the same clock as the market.
  • Your copy never breaks. Go offline and one call refills every missed bar; a second call delivers every value a source corrected later.
  • History: hourly crypto from 2017, FX from 2002.

Site: https://tillacrypto.com · Docs: https://tillacrypto.com/docs · Plans: https://tillacrypto.com/pricing

In your AI agent (MCP)

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

With uv there is nothing to install: "command": "uvx", "args": ["tilla-mcp"].

14 tools for Claude, Cursor or any MCP client: latest bars, history, one whole market at a time, the live tick, corrections and plans. Ask things like "BTC price against spot ETF flows this month" or "NVDA and BTC on one hourly chart". Tool list: mcp/README.md.

A key and a first call

A free key, no account and no card:

curl -X POST https://api.tillacrypto.com/v1/demo_key
curl -H "X-API-Key: tk_live_YOUR_KEY" "https://api.tillacrypto.com/v1/free/raw/1min?series=btc_close,eth_close&limit=5"

Every bar is labelled by its close, in UTC. A value a source never published stays empty; nothing is guessed. JSON, CSV, NDJSON or Parquet (format=). A Postman collection has every call ready to run.

What's in here

FolderWhat it is
starter/tilla_dashboard.py: a live terminal dashboard that keeps a SQLite copy current - resume what you missed, tick every new bar, heal what a source corrected. Standard library only.
mcp/tilla_mcp.py: the MCP server (also pip install tilla-mcp)
examples/three short scripts: a first call, every coin's close in one call, a day of data in pandas
postman/the API as a Postman collection
cd starter
python tilla_dashboard.py --keep tilla.db

The three calls behind it

  • Tick - GET /v1/<tier>/tick - every series your plan holds for the bar that just closed, in one answer
  • Resume - GET /v1/<tier>/resume/<layer>/<lane>?since=... - every bar since you stopped, streamed
  • Changes - GET /v1/<tier>/changes?since=... - every value corrected since a time, so your copy gets the fix

Safe to run

Everything here only reads market data from api.tillacrypto.com over HTTPS. Nothing trades, touches a wallet or reads your other files. Your key stays in your own .env or environment and goes only to the TILLA API. The only thing written is the SQLite file you name with --keep.

License

The code is MIT (LICENSE). The data you pull with it is covered by your TILLA plan: https://tillacrypto.com/docs

Contact

I answer every message myself: https://tillacrypto.com/contact, @TillaCryptoHub on X, or an issue on this repo.

Frequently asked questions

What is TILLA - market data on one clock?

Crypto, US stocks, FX, rates, macro and Bitcoin node data on one clock, for any AI agent.

How do I install TILLA - market data on one clock?

It runs on your machine. In Claude Code: claude mcp add tilla-market-data-on-one-clock -e 'TILLA_API_KEY=<your tilla_api_key>' -e 'TILLA_API_BASE=<TILLA_API_BASE>' -- uvx tilla-mcp==2.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does TILLA - market data on one clock need an API key?

Yes. It expects TILLA_API_KEY, which you set in its configuration.

Is TILLA - market data on one clock open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains TILLA - market data on one clock?

It is published by TillaCrypto. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.