MCP.Market

Xfinlab MCP server

online · 100% uptime
by lnanology·io.github.lnanology/xfinlab·v1.0.1
No reviews yet

Financial intelligence for AI agents: market events, sentiment, technicals, news feed.

A88/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

0 stars

Reviews

Write one

Nobody has reviewed Xfinlab yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Xfinlab tools (6)

write = sends, deletes, buys or posts
  • get_fundamentals_as_ofFree

    Point-in-time company fundamentals (fundamentals_as_of): what an investor could actually have known about a US-listed company on a given date. For a symbol and an as_of date (YYYY-MM-DD) it returns the annual SEC 10-K figures (revenue, net income, diluted EPS, total assets, total liabilities, operating cash flow) that had already been filed and were available by that date, each with the period it describes (data_time) and the SEC filing date (publication_time). Later restatements are never leaked back into an earlier date, which avoids look-ahead bias in backtests and research. Fields with no data public by that date are listed in unavailable_fields, never filled with zeros. Also returns source, quality and limitations. US SEC filers, annual data only; not investment advice.

  • get_global_market_mapFree

    Get a cross-region global market snapshot ('World Engine'): macro indicators (GDP growth/inflation/unemployment, with source attribution -- world_bank/fred/ecb), filtered regional headlines, and FinBERT sentiment for each requested region, plus a top-level global headlines feed (GDELT). Regions: us, europe, japan, korea, china, hk, tw, sea, me, latam. No AI narrative, no directional signal -- structured real data only.

  • get_intelligence_feedFree

    Get AI-structured event clusters from recent news: same-story headline clusters with entity/sentiment/quant-context fields and an AI-written narrative summary. Optionally scoped to one ticker; otherwise returns the latest cross-market feed. This is structured fact extraction, not republished article text, and never includes a directional trading signal or probability estimate.

  • get_market_eventsFree

    Get recent market/company news headlines from XFINLAB's aggregated real-time news feed (RSS-sourced, deduplicated). Optionally filter by ticker/company name. Returns title, source, kind, published_at, url for each item -- no article body text.

  • get_sentimentFree

    Get FinBERT-based sentiment analysis of recent headlines for a ticker. Returns per-headline label/confidence/score plus an average score. Real model inference, not a fabricated estimate.

  • get_technical_analysisFree

    Get confluence direction/confidence, trend, MACD, volume, chart patterns, and market-structure signals (BOS/CHOCH/liquidity-sweep/order-flow/volume-profile/institutional-footprint) for one ticker, computed from real OHLC price data -- the same engine that powers XFINLAB's chart-analysis and ai-analysis pages.

Public scan report

scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 558ms20/20
  • Tool poisoning6 tool descriptions checked15/15
  • Auth qualityAPI key sent as a header8/15
  • Maintenancelast push 15 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Xfinlab compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,243 servers
Tools
6
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote server answers 100%
Response time
104 ms
faster than 83% of 30,027 servers

What its tools let an agent do: 6 read

Release history: 2 versions in the registry since 2026-08-29, latest 2026-10-08, typically one every 40 days.

Install Xfinlab in Claude Code, Cursor or VS Code

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

What the publisher says

From the Xfinlab repository's README, as published. We do not edit it. Read it on GitHub

XFINLAB

Financial Intelligence Infrastructure — APIs, SDKs, and an MCP server for developers and AI agents, plus a consumer research platform built on the same backend.

Real market events, FinBERT sentiment, technical/market-structure analysis, SEC/CFTC/FDIC/USDA/CBOE official data, and Monte Carlo stress testing. Every field is traceable to a real computation or an official data source — nothing fabricated or interpolated.

Get a free API key · API docs · llms.txt · Consumer product

Quick start (API)

pip install "git+https://github.com/lnanology/Xfinlab.git#subdirectory=sdk/python"
from xfinlab_intelligence import XfinlabClient

client = XfinlabClient(api_key="xfl_...")  # free tier, issued instantly
sentiment = client.sentiment("AAPL")
technical = client.technical("AAPL", period="6mo")
fundamentals = client.fundamentals("AAPL")

Or JavaScript/Node:

npm install "github:lnanology/Xfinlab#path:sdk/js"
const { XfinlabClient } = require('xfinlab-intelligence');
const client = new XfinlabClient('xfl_...');
const sentiment = await client.sentiment('AAPL');

19 endpoints total — market events, sentiment, AI debate, technical/market-structure, Monte Carlo stress testing, insider trading, institutional ownership, short interest, SEC XBRL fundamentals, CBOE VIX term structure, FDIC bank health, USDA agriculture, EIA energy, crypto, cross-region market map, and Pro-tier webhooks. Full reference: intelligence-api.html.

MCP server (for Claude and other AI agents)

Every field this server returns is either a real computation/real official-source value, or null with an explanation — the MCP ecosystem has a lot of servers now, few of them say anything about the actual quality of the data behind the tool calls. This one does, in public: xfinlab.com/trust.html shows every underlying data collector's live/down status in real time.

Already live in production — no setup needed, just point an MCP-compatible client at it:

{
  "mcpServers": {
    "xfinlab": {
      "url": "https://api.xfinlab.com/api/mcp",
      "headers": { "X-API-Key": "xfl_..." }
    }
  }
}

Server source: api/mcpserver.py. Tools: getmarketevents, getsentiment, gettechnicalanalysis, getintelligencefeed, getglobalmarket_map. Same auth and free tier as the REST API. Docs: intelligence-api.html#mcp.

SDKs & examples

Both SDKs are MIT-licensed (sdk/LICENSE) and have zero required dependencies beyond the standard library / native fetch.

Consumer product

The same backend also powers xfinlab.com, a retail investment-research platform:

Local development

python3 mock-server.py

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Xfinlab: common questions

Is Xfinlab MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Xfinlab safety report
How do I install Xfinlab?
It runs remotely at api.xfinlab.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Xfinlab need an API key?
Yes. The registry entry asks for X-API-Key.
Is Xfinlab maintained?
The last commit was 21 days ago (2026-10-15). The latest release is v1.0.1.
Is Xfinlab up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Xfinlab?
Servers from other publishers that do the same job: World Monitor MCP server.
How does Xfinlab compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,243 servers); tools 6 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Xfinlab

Same job from other publishers: the closest match first, then the best rated.

  • World Monitor
    Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.
    A