# AllocContext — BTC/ETH allocation drift, rebalance moves & market context

Deterministic BTC/ETH portfolio allocation context for AI agents: allocation drift and band checks, USD rebalance plans, fused market context (Fear & Greed, Kalshi sentiment, macro calendar, FRED indicators, ETF flows), live Kraken/Coinbase portfolio reads, and saved ContextBundle snapshots. Structured JSON only — no LLM.

## Paid MCP (x402, Base stablecoins)

- Endpoint: `https://mcp.alloc-context.com/mcp`
- Transport: streamable HTTP (`POST /mcp`)
- Health: `https://mcp.alloc-context.com/health` (free)
- Payment: x402 exact scheme on Base; payer picks one of
  **USDC, EURC** (USD-pegged; bridge to Base first).
- Pricing: **$0.02** cached context/math; **$0.05** live ingest or live portfolio.

## Tools

- `get_market_context` — Fused market backdrop for BTC/ETH allocation: Fear & Greed, Kalshi sentiment, macro calendar, FRED indicators, ETF flows, and breadth. Use freshness=cached for hosted cache; freshness=live runs ingest first (requires ingest API keys on the host).
- `get_context_bundle` — Full ContextBundle JSON: portfolio allocation drift vs target, market, sentiment, macro, regime hints, and delta vs the prior saved snapshot. Optional assets, target_pct, and band override server config for drift math.
- `get_rebalance_plan` — Compute USD deltas and exchange-style move lines to rebalance a BTC/ETH/CASH portfolio toward target allocation from current weights and NAV. Pure math — rebalance plan for btc/eth splits.
- `get_portfolio_state` — Live portfolio read: NAV, BTC/ETH/CASH allocation, drift vs target, and band hint. Pass read-only kraken or coinbase credentials in the request; never stored server-side.
- `check_allocation_band` — Check whether BTC/ETH/CASH allocation is outside a drift band vs target and return hint (within_band, consider_rebalance, etc.).
- `get_context_at` — Load a saved ContextBundle snapshot from ingest history by ISO timestamp (match exact or at_or_before).
- `get_context_delta` — Compare two ContextBundle snapshots and return notable_shifts.
- `check_allocation_bands` — Evaluate allocation drift against multiple target/band scenarios.

## Search keywords

bitcoin, ethereum, btc, eth, portfolio allocation, allocation drift,
rebalance plan, rebalance btc eth, drift band, band check, market context,
fear and greed, sentiment, macro calendar, etf flows, agent tools, mcp, x402

## Examples

Redacted tool JSON samples (evaluate before paying):
https://github.com/negillett/alloc-context/blob/main/docs/examples.md