Skip to content
MCP server

Xfinlab

Market events, sentiment, technicals and macro data for AI agents, from official sources

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.1
Listing updated
1 day ago

About Xfinlab

Xfinlab is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.xfinlab.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xfinlab": {
      "url": "https://api.xfinlab.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free API key tier; paid tiers not published

Prices change. Check xfinlab.com before you buy.

Xfinlab 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 to Xfinlab

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments