xfinlab
Real-time market events, sentiment, and technical analysis as MCP tools, backed by real data.
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 (5)
🟢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": []
}Community
Evidence