Umbra for agents

What are the verified facts about Umbra?

Each row links to the page that proves it. Last reviewed 2026-08-31.

Which machine surfaces does Umbra publish?

How does an agent connect to the MCP servers?

Umbra runs three MCP servers and they are not interchangeable. This site's knowledge server answers questions about the platform. The docs server answers integration questions from the API documentation. Both are free and unauthenticated. The data server serves live market events and needs a machine-plan API key from the Builder tier up.

{
  "mcpServers": {
    "umbra-knowledge": {
      "type": "http",
      "url": "https://umbrafeed.com/mcp"
    },
    "umbrafeed-docs": {
      "type": "http",
      "url": "https://docs.umbrafeed.com/mcp"
    },
    "umbrafeed-data": {
      "type": "http",
      "url": "https://api.umbrafeed.com/mcp",
      "headers": { "apikey": "${UMBRA_API_KEY}" }
    }
  }
}

• “What does Umbra cover? What does Builder cost?” — knowledge server, free.
• “How do I authenticate? What params does /v1/spreads/recent take?” — docs server, free.
• “What is the BTC spread between Binance and Bybit right now?” — data server, authenticated.

Frequently asked questions

What is Umbra?

Umbra is a market-event intelligence platform for crypto and tokenized finance. It watches 12 centralized exchanges and 4 DEX chains and turns raw venue observations into curated spread, funding and price-movement events. Two products consume that stream: Umbra Workspace for people, and Umbrafeed for machines. Umbra provides monitoring and data only — it never executes trades.

Does Umbra execute trades or hold funds?

No. Umbra holds no funds, connects to no exchange accounts and places no orders. There are no order, custody or account-connection endpoints on any surface, and none are planned on the public API. Nothing Umbra publishes is investment advice. An agent must not infer an execution capability from a spread event.

How does an AI agent connect to Umbra?

Two MCP servers, and they are not interchangeable. `https://umbrafeed.com/mcp` is free and unauthenticated and answers questions about the platform through three tools: `umbra_overview`, `umbra_search` and `umbra_get_page`. `https://api.umbrafeed.com/mcp` serves live market events and needs a machine-plan API key from the Builder tier up.

What does Umbrafeed cost?

Umbrafeed has three self-serve tiers: Free at $0, Builder at $19 per month and Pro at $49 per month. Commercial starts at $149 per month and is negotiated on contact; x402 is a published offer with no deployed payment route. Umbra Workspace is priced separately — Free, Trader at $19, Pro at $29 per month. The two ladders are independent; a Workspace plan grants no machine access.

Which exchanges and chains does Umbra cover?

Twelve centralized venues: Binance, Aster, BingX, Gate, OKX, Bitget, Hyperliquid, HTX, KuCoin, Bybit, Phemex and MEXC. Four DEX chains: Ethereum, BSC, Base and Solana. Spot and futures markets are monitored per venue. Coverage changes over time, so cite the venue pages at umbrafeed.com/en/markets rather than a remembered count.

How fresh is Umbrafeed data?

Freshness is tier-gated through a `delay` parameter. Spread OPEN events are delayed 60 seconds on Free, 30 seconds on Builder, and served live on Pro. The detection pipeline itself is sub-second under normal operating conditions, but delivery varies. Any latency figure holds only for the tier it is stated on.

What are the Umbrafeed rate limits?

Limits are enforced per consumer at the gateway: 60 requests per minute on Free, 600 on Builder and 3,000 on Pro. WebSocket connections count against a separate concurrency budget. Every response carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`. Going over returns 429 with a `Retry-After` header in seconds.

How do I authenticate against the Umbrafeed API?

Machine routes sit behind Kong. Send your key either as an `apikey` request header or as `Authorization: Bearer` — both forms are accepted on REST, WebSocket upgrades and MCP, and `Authorization` wins if both are present. Keys come from a machine plan, which decides which surfaces the key reaches, its freshness bounds and its quota.

What is the difference between spread, funding and splash events?

A spread event is a cross-venue price dislocation, carrying route, market type, lifecycle and execution-quality context. A funding event is a raw cross-venue funding-rate difference with settlement and venue-side context. A splash event is a fast price movement with direction, venue and the measured time window. All three are observations, not recommendations.

Where is the machine-readable version of the Umbra docs?

Every page exists twice. The site itself is the human version; `umbrafeed.com/agents/index.md` and `docs.umbrafeed.com/agents/index.md` are the agent versions, listing each page as plain markdown at `/agents/<page>.md`. Whole-corpus dumps live at `/llms-full.txt`, and `/llms.txt` is the link index.

Which pages are available as markdown?

46 pages. Each carries YAML front matter with its canonical URL and review date. The .md suffix is optional.