AllocContext
negillett/alloc-context
Connects to Coinbase and Kraken via read-only API keys to pull your actual crypto holdings, then layers on scoped market data (OHLC for BTC/ETH, quote snapshots for alts), sentiment, macro indicators, and regime analysis. Exposes tools like get_context_bundle for a full snapshot, get_rebalance_plan for drift calculations, and check_allocation_band to see if you're outside target ranges. Runs locally via stdio for Cursor or hits the hosted endpoint at mcp.alloc-context.com with x402 micropayments on Base. Pricing is two to five cents per call depending on whether it's cached math or live portfolio ingest. Nothing persists on the server. Reach for this when you want an agent to reason about portfolio allocation without manually copying balances into prompts.
- tools
- 8
- transport
- STDIO, HTTP
- last updated
- Jun 1, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
get_market_contextReturn read-only fused market backdrop for crypto portfolio context: sentiment (Fear & Greed, Kalshi), macro events, FRED indicators, ETF flows, and market breadth — no portfolio holdings. Use get_context_bundle when you also need holdings, delta, or regime. freshness=cached r...3 params
Return read-only fused market backdrop for crypto portfolio context: sentiment (Fear & Greed, Kalshi), macro events, FRED indicators, ETF flows, and market breadth — no portfolio holdings. Use get_context_bundle when you also need holdings, delta, or regime. freshness=cached r...
Parameters* required
assetsarrayOptional asset symbols for market fields (default BTC and ETH), e.g. ['BTC', 'ETH', 'HYPE'].
freshnessstringcached: read local ingest DB only. live: run ingest first (requires ingest API keys on the host).one of
cached · livescopestringRollup scope: daily (default) or weekly.one of
daily · weeklyget_context_bundleReturn the full read-only ContextBundle JSON: portfolio holdings, market, sentiment, macro, regime hints, and delta vs the prior saved snapshot. Use get_market_context for market-only; use get_context_at for a historical snapshot. Optional target_pct and band attach allocation...5 params
Return the full read-only ContextBundle JSON: portfolio holdings, market, sentiment, macro, regime hints, and delta vs the prior saved snapshot. Use get_market_context for market-only; use get_context_at for a historical snapshot. Optional target_pct and band attach allocation...
Parameters* required
assetsarrayOptional asset symbols for market fields (default BTC and ETH), e.g. ['BTC', 'ETH', 'HYPE'].
bandnumberDrift band width as a fraction (e.g. 0.15 = 15% outside target).
freshnessstringcached: read local ingest DB only. live: run ingest first (requires ingest API keys on the host).one of
cached · livescopestringRollup scope: daily (default) or weekly.one of
daily · weeklytarget_pctobjectOptional target weights; when set, attaches allocation_analysis drift math to the response.
get_rebalance_planCompute read-only USD deltas and suggested exchange move lines to reach a BTC/ETH/CASH target split. Pure math — no exchange API calls. Requires allocation_pct, target_pct, and nav_usd. Use get_portfolio_state or get_context_bundle when you need live weights first.5 params
Compute read-only USD deltas and suggested exchange move lines to reach a BTC/ETH/CASH target split. Pure math — no exchange API calls. Requires allocation_pct, target_pct, and nav_usd. Use get_portfolio_state or get_context_bundle when you need live weights first.
Parameters* required
allocation_pctobjectCurrent BTC/ETH/CASH band weights; values typically sum to ~1.
bandnumberDrift band width as a fraction (e.g. 0.15 = 15% outside target).
exchangestringSpot exchange for move wording: kraken (default) or coinbase.one of
kraken · coinbasenav_usdnumberPortfolio net asset value in USD.
target_pctobjectTarget BTC/ETH/CASH band weights; values typically sum to ~1.
get_portfolio_stateFetch live read-only portfolio NAV, holdings[], and band weights from a supported spot exchange (e.g. Kraken, Coinbase) using credentials passed in this call (never stored). Requires exchange, api_key, and api_secret. Returns available=false with reason on invalid credentials...5 params
Fetch live read-only portfolio NAV, holdings[], and band weights from a supported spot exchange (e.g. Kraken, Coinbase) using credentials passed in this call (never stored). Requires exchange, api_key, and api_secret. Returns available=false with reason on invalid credentials...
Parameters* required
api_keystringRead-only exchange API key (Coinbase CDP key name).
api_secretstringRead-only API secret (Kraken base64 secret or Coinbase EC PEM).
bandnumberDrift band width as a fraction (e.g. 0.15 = 15% outside target).
exchangestringSpot exchange to query: kraken or coinbase.one of
kraken · coinbasetarget_pctobjectOptional target weights; when set, attaches allocation_analysis to the portfolio response.
check_allocation_bandCheck read-only drift: are BTC/ETH/CASH band weights outside the drift band vs target_pct? Returns rebalance_hint (within_band, consider_rebalance, etc.). Single scenario — use check_allocation_bands for multiple targets. Use get_rebalance_plan when you need USD move lines.3 params
Check read-only drift: are BTC/ETH/CASH band weights outside the drift band vs target_pct? Returns rebalance_hint (within_band, consider_rebalance, etc.). Single scenario — use check_allocation_bands for multiple targets. Use get_rebalance_plan when you need USD move lines.
Parameters* required
allocation_pctobjectCurrent BTC/ETH/CASH band weights; values typically sum to ~1.
bandnumberDrift band width as a fraction (default 0.15 = 15%).
target_pctobjectTarget BTC/ETH/CASH band weights; values typically sum to ~1.
get_context_atLoad a read-only ContextBundle snapshot from ingest history at a point in time. Use get_context_bundle for the latest snapshot; use get_context_delta to compare two timestamps. Returns unavailable when no snapshot matches as_of and match.6 params
Load a read-only ContextBundle snapshot from ingest history at a point in time. Use get_context_bundle for the latest snapshot; use get_context_delta to compare two timestamps. Returns unavailable when no snapshot matches as_of and match.
Parameters* required
as_ofstringISO-8601 timestamp for the snapshot to load.
assetsarrayOptional asset symbols for market fields (default BTC and ETH), e.g. ['BTC', 'ETH', 'HYPE'].
bandnumberDrift band width as a fraction (e.g. 0.15 = 15% outside target).
matchstringexact: snapshot at as_of only. at_or_before (default): latest snapshot on or before as_of.one of
exact · at_or_beforescopestringRollup scope: daily (default) or weekly.one of
daily · weeklytarget_pctobjectOptional target weights; when set, attaches allocation_analysis drift math to the response.
get_context_deltaCompare two read-only ContextBundle snapshots and return notable_shifts between them. Requires prior_as_of; omit current_as_of to diff against the latest live bundle. Use get_context_at to load one snapshot without diffing.4 params
Compare two read-only ContextBundle snapshots and return notable_shifts between them. Requires prior_as_of; omit current_as_of to diff against the latest live bundle. Use get_context_at to load one snapshot without diffing.
Parameters* required
assetsarrayOptional asset symbols for market fields (default BTC and ETH), e.g. ['BTC', 'ETH', 'HYPE'].
current_as_ofstringISO-8601 timestamp of the later snapshot; omit for latest live bundle.
prior_as_ofstringISO-8601 timestamp of the earlier snapshot (required).
scopestringRollup scope: daily (default) or weekly.one of
daily · weeklycheck_allocation_bandsEvaluate read-only allocation drift against multiple target_pct/band scenarios in one call. Each scenario requires target_pct; optional name and band (default 0.15). Use check_allocation_band for a single target.2 params
Evaluate read-only allocation drift against multiple target_pct/band scenarios in one call. Each scenario requires target_pct; optional name and band (default 0.15). Use check_allocation_band for a single target.
Parameters* required
allocation_pctobjectCurrent BTC/ETH/CASH band weights; values typically sum to ~1.
scenariosarrayScenario objects, each with required target_pct and optional name and band (default 0.15).
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageReadme
Details
- Repository
- github.com/negillett/alloc-context
- Website
- mcp.alloc-context.com/llms.txt
- Category
- Finance & Commerce
- Package
alloc-context- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
