Skip to content

io.github.lnanology/xfinlab

by lnanology · remote · no sign-in to list tools · v1.0.1 · published by GitHub user lnanology

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

Read only

6 tools: 6 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http xfinlab https://api.xfinlab.com/api/mcp --header 'X-API-Key: <your-x-api-key>'

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

6 tools

Only reads 6Claude Code: allow
  • get_fundamentals_as_ofPoint-in-time company fundamentals (fundamentals_as_of): what an investor could actually have known about a US-listed company on a given date.No findings

    Why it is in this group

    • The name "get_fundamentals_as_of" says "get": a word for reading.
    Description, as the server wrote 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.

    Annotations the server declares

    • title: Point-in-time fundamentals
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_global_market_mapGet a cross-region global market snapshot ('World Engine'): macro indicators (GDP growth/inflation/unemployment, with source attribution -- world_bank/fred/ecb), filtered regional …No findings

    Why it is in this group

    • The name "get_global_market_map" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Global market map
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_intelligence_feedGet AI-structured event clusters from recent news: same-story headline clusters with entity/sentiment/quant-context fields and an AI-written narrative summary.No findings

    Why it is in this group

    • The name "get_intelligence_feed" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Intelligence feed
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_market_eventsGet recent market/company news headlines from XFINLAB's aggregated real-time news feed (RSS-sourced, deduplicated).No findings

    Why it is in this group

    • The name "get_market_events" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Market events
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_sentimentGet FinBERT-based sentiment analysis of recent headlines for a ticker.No findings

    Why it is in this group

    • The name "get_sentiment" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Headline sentiment
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_technical_analysisGet confluence direction/confidence, trend, MACD, volume, chart patterns, and market-structure signals (BOS/CHOCH/liquidity-sweep/order-flow/volume-profile/institutional-footprint)…No findings

    Why it is in this group

    • The name "get_technical_analysis" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Technical analysis
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http xfinlab https://api.xfinlab.com/api/mcp --header 'X-API-Key: <your-x-api-key>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__xfinlab__get_market_events",
      "mcp__xfinlab__get_sentiment",
      "mcp__xfinlab__get_technical_analysis",
      "mcp__xfinlab__get_intelligence_feed",
      "mcp__xfinlab__get_global_market_map",
      "mcp__xfinlab__get_fundamentals_as_of"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as xfinlab. Review it before you use it.