# Fahali

> Fahali is a freemium MCP server for finance and payments. Market-risk warnings for agents, with lead-time stats and a tracked record of misses. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://app.fahaliai.com
- **Repository:** https://github.com/bobmain-2025/fahali-mcp
- **MCP Registry name:** com.fahaliai/fahali
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Fahali watches around 2,000 live crypto and US equity and ETF instruments with an ensemble of detection engines for absorption patterns, liquidity anomalies, crash precursors and regime shifts. Detections are logged in a signal-to-outcome ledger, and responses carry uncertainty and provenance. The README states plainly that it is informational and not financial advice.

Tools are tiered. Market snapshots, sentiment history, priority risk clusters, shock tests in natural language and the lead-time report are Free. Market and symbol decisions, regime detection, flash-crash risk, forecasts and capital-flow proxies need Professional, while portfolio risk and custom-portfolio analysis need Elite.

The lead-time tool reports measured hours of warning per engine, misses included, and tells callers to quote its headline figure rather than cherry-pick. The web app describes a read-only portfolio watch for investment offices, scored in dollars.

## Features

- **Lead-time reporting:** Measured hours of warning ahead of correct calls, with misses counted.
- **Shock tests:** Natural-language scenario stress tests that estimate capital at risk.
- **Regime detection:** Four-state hidden Markov classification of the market.
- **Portfolio risk:** Risk score, VaR, drawdown and per-position breakdown for a book.
- **Flow proxies:** Candle-derived buy-versus-sell imbalance and microstructure observations.
- **Forecast cone:** Crash, pump and neutral probabilities with a p10 to p90 range.
- **Contagion map:** Graph of tail-dependence links between instruments.

## Good for

- Add market-risk context to a trading research agent
- Stress-test a holding against a described scenario
- Check which engines gave real advance warning
- Track a daily diff of alerts and regimes
- Review which positions share the same bet

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http fahali https://mcp.fahaliai.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.fahaliai.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fahali": {
      "url": "https://mcp.fahaliai.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fahali": {
      "type": "http",
      "url": "https://mcp.fahaliai.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fahali": {
      "serverUrl": "https://mcp.fahaliai.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fahali": {
      "type": "http",
      "url": "https://mcp.fahaliai.com/mcp"
    }
  }
}
```

## Tools

- `fahali_get_market_decision`: Market-wide judgment with evidence, conflicts and invalidation.
- `fahali_get_symbol_decision`: Binding judgment for one named instrument.
- `fahali_get_market_snapshot`: Live prices and changes for all instruments.
- `fahali_get_market_regime`: Four-regime hidden Markov detection.
- `fahali_get_market_sentiment`: Sentiment history with score and direction.
- `fahali_get_highest_conviction_signals`: Priority risk clusters.
- `fahali_daily_brief`: Yesterday versus today market intelligence diff.
- `fahali_get_market_risk_score`: Global 0-100 market-risk context.
- `fahali_get_flash_crash_risk`: Early-warning strength and triggers.
- `fahali_get_portfolio_risk`: Risk score, VaR, drawdown and per-position breakdown.
- `fahali_analyze_custom_portfolio`: Stateless risk analysis of a supplied book.
- `fahali_run_shock_test`: Natural-language scenario stress test.
- `fahali_get_forecast`: Crash, pump and neutral probabilities with an uncertainty cone.
- `fahali_get_lead_time`: Per-engine measured hours of warning, misses included.
- `fahali_get_contagion_map`: Contagion graph with tail-dependence edges.

## FAQ

### Is it financial advice?

No. The README says it is informational only and detects anomalies without telling anyone what to buy or sell.

### Which tools are free?

Market snapshot, sentiment history, highest-conviction signals, shock tests, the lead-time report and a daily brief teaser.

### What does it cover?

About 2,000 live crypto and US equity and ETF instruments.

### What is the connection address?

https://mcp.fahaliai.com/mcp over Streamable HTTP, with an SSE endpoint at /sse.

### Is Fahali free?

Fahali has a free plan, with paid plans for more usage or features.

### How do I add Fahali to Claude Code?

Run this command in your terminal: claude mcp add --transport http fahali https://mcp.fahaliai.com/mcp

### What are the best alternatives to Fahali?

The closest alternatives to Fahali are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/fahali
