# Fahali MCP Server
> Model Context Protocol server for Fahali's autonomous market-risk intelligence. An ensemble of independent detection engines scanning ~2,000 live markets (crypto + US equities/ETFs), real-time anomaly detection with verified signal→outcome provenance. The live roster and each engine's judged record are published at https://app.fahaliai.com/api/track-record/engines — the edge is in the composition, not the count. Informational only — not financial advice.

## Endpoints
- SSE transport: https://mcp.fahaliai.com/sse
- Messages endpoint: https://mcp.fahaliai.com/messages?sessionId={sessionId}
- Health: https://mcp.fahaliai.com/health
- Landing page: https://mcp.fahaliai.com/
- llms.txt: https://mcp.fahaliai.com/llms.txt

## Authentication
Clients must provide a Fahali API key via:
- Authorization: Bearer <FAHALI_API_KEY> header on SSE handshake, or
- ?api_key=<FAHALI_API_KEY> query parameter on the SSE URL
Create a key at https://app.fahaliai.com/developer

## Tools (22 total)

### Markets & verdict
- fahali_get_market_verdict — direction, confidence, reasoning chain per symbol (Professional)
- fahali_get_market_snapshot — live prices, changes, asset class for all instruments (Free)
- fahali_get_market_regime — HMM 4-regime detection (Free)
- fahali_get_market_sentiment — sentiment history with score and direction (Free)
- fahali_get_highest_conviction_signals — multi-engine consensus ranked by agreement (Free)
- fahali_daily_brief — yesterday vs today market intelligence diff (Free teaser / Professional)

### Risk & crash
- fahali_get_institutional_risk_score — weighted 0-100 risk across the active detection fleet (Free)
- fahali_get_flash_crash_risk — crash probability, triggers, risk flags per symbol (Free)
- fahali_get_portfolio_risk — VaR, drawdown, per-position breakdown from connected accounts (Elite)
- fahali_analyze_custom_portfolio — risk analysis on a portfolio you provide inline (Free)
- fahali_run_shock_test — natural-language stress test with capital at risk (Free)

### Smart money & flow
- fahali_get_detection_activity — bullish/bearish split of detection alerts per symbol; NOT institutional flow, no venue order-flow feed and we cannot identify who traded (Free)
- fahali_get_whale_activity — whale trades, phases, entry prices (Free)
- fahali_get_microstructure_proxy — absorption proxy inferred from public microstructure only; we see no off-exchange prints (Free)
- fahali_get_capital_flow — net buyer- vs seller-initiated volume per symbol from the public trade tape; not participant-identified (Professional)
- fahali_get_forecast — crash/pump/neutral probabilities with a p10/p50/p90 uncertainty cone (was fahali_get_72h_forecast) (Professional)
- fahali_get_lead_time — per engine: measured hours of warning ahead of its correct calls, misses included (Free)
- fahali_get_market_briefing — full executive market analysis for today; PARTIAL when subsystems disagree (Free)

### Contagion & correlation
- fahali_get_contagion_map — contagion graph with tail-dependence edges (Elite)
- fahali_get_correlation_matrix — cross-asset correlation and contagion risk (Free)

### Portfolio & alerts
- fahali_get_portfolio_metrics — sentiment momentum, cascade risk, liquidity stress (Free)
- fahali_get_realtime_alerts — unified detection feed from the active fleet (Free)

### Proof & system
- fahali_get_track_record_scorecard — honest 4-axis accuracy with base-rate lift (Free)
- fahali_get_case_studies — 40 verified signal→outcome cases (Free)
- fahali_get_engine_status — liveness report for the active detection fleet (Free)
- fahali_get_visual_intelligence — unified constellation graph of the active fleet (Free)

## Resources
- API docs: https://app.fahaliai.com/openapi.json
- Methodology: https://fahaliai.com/methodology
- Accuracy: https://fahaliai.com/accuracy
- Pricing: https://app.fahaliai.com/pricing
- App: https://app.fahaliai.com
- Landing: https://fahaliai.com
- Live constellation: https://app.fahaliai.com/live
- Insights: https://app.fahaliai.com/insights

## Company
Future Legends AI — Fahali detects market risk before it becomes loss.