# Xfinlab

> Xfinlab is a freemium MCP server for finance and payments. Market events, sentiment, technicals and macro data for AI agents, from official sources. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://www.xfinlab.com/intelligence-api.html
- **Repository:** https://github.com/lnanology/xfinlab
- **MCP Registry name:** io.github.lnanology/xfinlab
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-16

## About

This hosted server fronts a financial intelligence API of about 20 JSON endpoints. Beyond news sentiment scored with FinBERT and a feed of market events, it covers technical and market-structure analysis, Monte Carlo stress testing, insider transactions, institutional ownership, short interest and SEC XBRL fundamentals. It also draws on CBOE VIX term structure, FDIC bank health, USDA agriculture and energy data, with a multi-agent debate endpoint on top.

The project's stated rule is that every field is either a real computation or an official-source value, or null with an explanation. Its docs give examples: raw price bars are never returned, a missing XBRL concept is never replaced by a zero, and unrelated tickers never receive invented readings. The MCP server is the proprietary hosted layer at api.xfinlab.com, called with an X-API-Key header.

SDKs for Python and Node sit alongside the same API, and responses carry rate-limit headers so a client can pace itself. The README is candid that usage is early-stage.

## Features

- **Sentiment scoring:** FinBERT sentiment for tickers, with up to 10 tickers per request.
- **Market events feed:** Structured market events and an intelligence news feed.
- **Technical analysis:** Computed trend, pattern and confluence fields rather than raw price bars.
- **Point-in-time fundamentals:** Annual 10-K figures from SEC filers back to 2009.
- **Official data sources:** SEC, CFTC, FDIC, USDA and CBOE datasets reported as null when unavailable.
- **Rate-limit headers:** Each response shows remaining quota.

## Good for

- Add sentiment and event context to a trading research agent
- Check insider and short-interest data for a ticker
- Pull point-in-time fundamentals for a backtest
- Stress-test a position with Monte Carlo output

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http xfinlab https://api.xfinlab.com/api/mcp
```

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

```sh
https://api.xfinlab.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "xfinlab": {
      "url": "https://api.xfinlab.com/api/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "xfinlab": {
      "serverUrl": "https://api.xfinlab.com/api/mcp"
    }
  }
}
```

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

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

## Tools

- `get_market_events`: Structured market events.
- `get_sentiment`: Sentiment for a ticker.
- `get_technical_analysis`: Technical and market-structure analysis.
- `get_intelligence_feed`: News and intelligence feed.
- `get_global_market_map`: Cross-market overview.
- `get_fundamentals_as_of`: Point-in-time SEC fundamentals.

## FAQ

### Is there a free tier?

The README mentions a free tier whose API key is issued instantly.

### How do I connect an MCP client?

Point it at https://api.xfinlab.com/api/mcp and send your key in an X-API-Key header.

### What happens when data is missing?

The fields return null with an explanation instead of a made-up value.

### Is the server open source?

The README says the server implementation is proprietary and hosted.

### Is Xfinlab free?

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

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

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

### What are the best alternatives to Xfinlab?

The closest alternatives to Xfinlab 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/xfinlab
