Financial intelligence for AI agents: market events, sentiment, technicals, news feed.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
XFINLAB API key. Get a free key at https://www.xfinlab.com/intelligence-api.html
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Date to evaluate, YYYY-MM-DD, e.g. '2023-06-30'.
US ticker, e.g. 'AAPL'.
XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead.
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.
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.
| Argument | Type | Description |
|---|---|---|
| as_of* | string | Date to evaluate, YYYY-MM-DD, e.g. '2023-06-30'. |
| symbol* | string | US ticker, e.g. 'AAPL'. |
| api_key | string | XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead. |
| marketplace_license_key | string | 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. |
{
"type": "object",
"required": [
"symbol",
"as_of"
],
"properties": {
"as_of": {
"type": "string",
"description": "Date to evaluate, YYYY-MM-DD, e.g. '2023-06-30'."
},
"symbol": {
"type": "string",
"description": "US ticker, e.g. 'AAPL'."
},
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| api_key | string | XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead. |
| regions | string | Comma-separated region keys, e.g. 'us,hk,china'. Omit for all 10 regions. |
| news_limit | integer | Headlines per region, 1-20. |
| include_sentiment | boolean | Whether to run FinBERT sentiment on each region's headlines. |
| marketplace_license_key | string | 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. |
{
"type": "object",
"required": [],
"properties": {
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"regions": {
"type": "string",
"description": "Comma-separated region keys, e.g. 'us,hk,china'. Omit for all 10 regions."
},
"news_limit": {
"type": "integer",
"default": 6,
"description": "Headlines per region, 1-20."
},
"include_sentiment": {
"type": "boolean",
"default": true,
"description": "Whether to run FinBERT sentiment on each region's headlines."
},
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language for the narrative summary. |
| limit | integer | Max event clusters, 1-10. |
| ticker | string | Optional ticker to scope the feed to, e.g. 'MSFT'. |
| api_key | string | XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead. |
| marketplace_license_key | string | 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. |
{
"type": "object",
"required": [],
"properties": {
"lang": {
"type": "string",
"default": "en",
"description": "Language for the narrative summary."
},
"limit": {
"type": "integer",
"default": 5,
"description": "Max event clusters, 1-10."
},
"ticker": {
"type": "string",
"description": "Optional ticker to scope the feed to, e.g. 'MSFT'."
},
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results, 1-100. |
| ticker | string | Optional ticker or company name to filter by, e.g. 'NVDA'. |
| api_key | string | XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead. |
| marketplace_license_key | string | 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. |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"description": "Max results, 1-100."
},
"ticker": {
"type": "string",
"description": "Optional ticker or company name to filter by, e.g. 'NVDA'."
},
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Number of recent headlines to analyze, 1-25. |
| ticker* | string | Ticker to analyze, e.g. 'AAPL'. |
| api_key | string | XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead. |
| marketplace_license_key | string | 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. |
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"description": "Number of recent headlines to analyze, 1-25."
},
"ticker": {
"type": "string",
"description": "Ticker to analyze, e.g. 'AAPL'."
},
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language for text labels, e.g. 'en', 'zh-HK'. |
| period | string | History window, e.g. '6mo', '1y'. |
| ticker* | string | Ticker to analyze, e.g. 'TSLA', '0700.HK'. |
| api_key | string | XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead. |
| interval | string | Candle interval, e.g. '1d'. |
| marketplace_license_key | string | 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. |
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"lang": {
"type": "string",
"default": "en",
"description": "Language for text labels, e.g. 'en', 'zh-HK'."
},
"period": {
"type": "string",
"default": "6mo",
"description": "History window, e.g. '6mo', '1y'."
},
"ticker": {
"type": "string",
"description": "Ticker to analyze, e.g. 'TSLA', '0700.HK'."
},
"api_key": {
"type": "string",
"description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
},
"interval": {
"type": "string",
"default": "1d",
"description": "Candle interval, e.g. '1d'."
},
"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."
}
}
}