xfinlab
Financial intelligence for AI agents: market events, sentiment, technicals, news feed.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"xfinlab": {
"url": "https://api.xfinlab.com/api/mcp"
}
}
}Remote endpoints
https://api.xfinlab.com/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢get_market_events(api_key, marketplace_license_key, ticker, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"marketplace_license_key": {
"type": "string",
"description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
},
"ticker": {
"type": "string",
"description": "Optional ticker or company name to filter by, e.g. 'NVDA'."
},
"limit": {
"type": "integer",
"description": "Max results, 1-100.",
"default": 20
}
},
"required": []
}🟢get_sentiment(api_key, marketplace_license_key, ticker, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"marketplace_license_key": {
"type": "string",
"description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
},
"ticker": {
"type": "string",
"description": "Ticker to analyze, e.g. 'AAPL'."
},
"limit": {
"type": "integer",
"description": "Number of recent headlines to analyze, 1-25.",
"default": 10
}
},
"required": [
"ticker"
]
}🟢get_technical_analysis(api_key, marketplace_license_key, ticker, period, interval, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"marketplace_license_key": {
"type": "string",
"description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
},
"ticker": {
"type": "string",
"description": "Ticker to analyze, e.g. 'TSLA', '0700.HK'."
},
"period": {
"type": "string",
"description": "History window, e.g. '6mo', '1y'.",
"default": "6mo"
},
"interval": {
"type": "string",
"description": "Candle interval, e.g. '1d'.",
"default": "1d"
},
"lang": {
"type": "string",
"description": "Language for text labels, e.g. 'en', 'zh-HK'.",
"default": "en"
}
},
"required": [
"ticker"
]
}🟢get_intelligence_feed(api_key, marketplace_license_key, ticker, limit, lang)
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.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"marketplace_license_key": {
"type": "string",
"description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
},
"ticker": {
"type": "string",
"description": "Optional ticker to scope the feed to, e.g. 'MSFT'."
},
"limit": {
"type": "integer",
"description": "Max event clusters, 1-10.",
"default": 5
},
"lang": {
"type": "string",
"description": "Language for the narrative summary.",
"default": "en"
}
},
"required": []
}🟢get_global_market_map(api_key, marketplace_license_key, regions, news_limit, include_sentiment)
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.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"marketplace_license_key": {
"type": "string",
"description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
},
"regions": {
"type": "string",
"description": "Comma-separated region keys, e.g. 'us,hk,china'. Omit for all 10 regions."
},
"news_limit": {
"type": "integer",
"description": "Headlines per region, 1-20.",
"default": 6
},
"include_sentiment": {
"type": "boolean",
"description": "Whether to run FinBERT sentiment on each region's headlines.",
"default": true
}
},
"required": []
}🟢get_fundamentals_as_of(api_key, marketplace_license_key, symbol, as_of)
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.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"marketplace_license_key": {
"type": "string",
"description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
},
"symbol": {
"type": "string",
"description": "US ticker, e.g. 'AAPL'."
},
"as_of": {
"type": "string",
"description": "Date to evaluate, YYYY-MM-DD, e.g. '2023-06-30'."
}
},
"required": [
"symbol",
"as_of"
]
}Community
Evidence