The Tape — API & MCP

Programmatic access to market sentiment, candles, trades, bot status, and backtests — over the Model Context Protocol. One endpoint, one bearer key.

Quickstart

1. Create an API key — in your account → API Keys (verify your email first). The secret is shown once; store it safely.
2. Add the server to your MCP client (Claude Desktop, Cursor) — see below.
3. Ask or call — your client can now use the tools listed in the catalog.

Authentication

Every request sends your key as a bearer token:

CopyAuthorization: Bearer tc_live_YOUR_KEY_HERE

The MCP endpoint is https://mcp.ubiity.com/mcp. Keys are managed in your account — they're shown once at creation and can be revoked anytime. Treat a key like a password.

Connect from an MCP client

Add this to your client's MCP config (e.g. Claude Desktop claude_desktop_config.json or Cursor mcp.json):

Copy{
  "mcpServers": {
    "trade-center": {
      "url": "https://mcp.ubiity.com/mcp",
      "headers": { "Authorization": "Bearer tc_live_YOUR_KEY_HERE" }
    }
  }
}

Quick test with curl

List the tools your key can see (streamable-HTTP MCP requires the Accept header shown):

Copycurl -s https://mcp.ubiity.com/mcp \
  -H "Authorization: Bearer tc_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Python

Using the official mcp client SDK (pip install mcp):

Copyimport asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.ubiity.com/mcp"
HEADERS = {"Authorization": "Bearer tc_live_YOUR_KEY_HERE"}

async def main():
    async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool("get_sentiment_summary", {"period": "30d"})
            print(result)

asyncio.run(main())

Tool catalog

No P&L, no core portfolio, and no internal event logs are ever exposed over the API.

Tiers & rate limits

The free tier allows 200 calls/day; paid is unlimited. When you exceed the free cap a tool call returns:

CopyDaily API rate limit exceeded (201/200 calls). Upgrade your plan for a higher limit.

Paid-only and add-on tools return a clear message if your plan doesn't include them (see Troubleshooting).

Bulk data export

Paid plans can pull large candle ranges as CSV or Parquet from a plain HTTPS endpoint (not MCP):

Copycurl -s "https://mcp.ubiity.com/data/candles?symbol=SPY&start=2024-01-01&end=2024-12-31&format=csv" \
  -H "Authorization: Bearer tc_live_YOUR_KEY_HERE" -o spy_2024.csv

Troubleshooting