Skip to main content
Glama
finlight-mcp

finlight-mcp

finlight MCP Server

English | 简体中文 | 日本語 | 한국어

mcp-name: me.finlight/news

finlight-mcp MCP server npm

Real-time financial news for AI agents. Connect Claude, ChatGPT, Cursor, or any MCP client to finlight, a financial news API covering global markets, geopolitics, and company-level news with sentiment analysis and entity tagging.

Endpoint: https://mcp.finlight.me (remote, streamable HTTP) Auth: OAuth 2.0 (you'll be prompted for your finlight API key during connection) Registry: me.finlight/news

What you can do

Ask your AI assistant things like:

  • "What's the latest news on NVDA? Summarize sentiment."

  • "Any market-moving headlines in the last 2 hours?"

  • "Compare news coverage of the Fed decision across sources."

  • "Find recent articles about semiconductor export restrictions and list the companies mentioned."

  • "Which sources does finlight cover for Chinese market news?"

Related MCP server: alphai-news

Tools

Tool

Description

search_articles

Search financial news articles with filters for query, tickers, sources, countries, language, and date range. Returns articles with metadata, sentiment scores, and tagged company entities.

get_article_by_link

Retrieve a specific article by its URL, including full enrichment (sentiment, confidence, tagged companies with tickers and ISINs).

list_sources

List all available news sources with country of origin and content availability.

Setup

You need a finlight API key. Sign up at app.finlight.me — the free tier is enough to try every tool below.

Claude (web / desktop)

  1. Go to Settings → Connectors → Add custom connector

  2. Enter https://mcp.finlight.me

  3. Complete the OAuth flow: you'll be asked to paste your finlight API key once

Claude Code

claude mcp add --transport http finlight https://mcp.finlight.me

Cursor

Add to your MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "finlight": {
      "url": "https://mcp.finlight.me"
    }
  }
}

ChatGPT (developer mode / connectors)

Add https://mcp.finlight.me as a remote MCP server and complete the OAuth flow with your API key.

Stdio / local usage

For MCP clients that only support stdio transport (or if you prefer a locally spawned process), use the npm wrapper:

npx finlight-mcp

This bridges stdio to the remote server via mcp-remote. Add it to any client config that takes a command + args:

{
  "mcpServers": {
    "finlight": {
      "command": "npx",
      "args": ["-y", "finlight-mcp"]
    }
  }
}

The OAuth flow is the same — a browser window will open for you to enter your API key on first use.

For headless or CI environments where no browser is available, set FINLIGHT_API_KEY to skip OAuth and authenticate directly:

{
  "mcpServers": {
    "finlight": {
      "command": "npx",
      "args": ["-y", "finlight-mcp"],
      "env": {
        "FINLIGHT_API_KEY": "your-api-key"
      }
    }
  }
}

How auth works

The server supports two authentication methods:

  1. OAuth 2.0 (default): Dynamic client registration with PKCE. A browser window opens for you to enter your finlight API key. Works out of the box with any MCP client that speaks OAuth.

  2. API key via header: Set the FINLIGHT_API_KEY environment variable to skip the browser flow. The key is sent as a Bearer token directly.

About the data

finlight aggregates and enriches financial news from curated, finance-relevant sources including major wire services, financial publishers, and regional sources in Chinese, Japanese, Korean and Arabic (with English canonical entity tagging). Articles include:

  • Sentiment score with confidence

  • Tagged company entities with tickers, ISINs, and exchange listings

  • Source, language, country, and publish metadata

The MCP server uses the same data as the REST and WebSocket APIs.

Rate limits and plans

MCP requests count toward your API quota. See pricing for the current free-tier limit and for paid tiers with real-time access, higher limits, and additional features.

Feedback

Issues and feature requests for the MCP server are welcome here on GitHub. For API questions, use Discord or the support channels above.

Available Tools

3 tools
get_article_by_linkAInspect

Retrieve a specific financial news article by its URL from the Finlight database.

Use this when you have an article URL and want to get its full details including:

  • Title, summary, and publication date

  • Source domain and language

  • Sentiment analysis (positive/negative/neutral) with confidence score

  • Optionally: full article content and tagged company entities

This is useful for getting details about a specific article you found elsewhere or for enriching article data with sentiment and entity information.

Inputs: link (required), includeContent, includeEntities.

list_sourcesAInspect

Get a list of all available news sources.

Returns metadata for each source including:

  • domain: The source website domain (e.g., "www.reuters.com")

  • isDefaultSource: Whether this source is included by default in search results

  • isContentAvailable: Whether full article content can be retrieved for this source (requires subscription)

Use this to discover available sources before filtering with the search_articles tool. Default sources are high-quality financial news outlets included automatically. Non-default sources can be added using the optInSources parameter in search_articles.

Inputs: no named parameters.

search_articlesAInspect

Search for financial news articles. Returns market-relevant news enriched with sentiment analysis and optional company entity tagging.

Key features:

  • Advanced query language with boolean operators (AND, OR, NOT) and field filters (ticker:AAPL, source:reuters.com)

  • Filter by stock tickers, countries, categories, sources, date ranges, and language

  • Each article includes sentiment analysis (positive/negative/neutral) with confidence scores

  • Optional full article content and tagged company entities (requires subscription)

Response includes: title, summary, publishDate, source, language, sentiment, confidence, and optionally content and companies array.

Inputs: to, from, page, order, +13 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct function: search_articles performs query-based search with advanced filters, get_article_by_link retrieves a specific article by URL, and list_sources provides metadata on available news sources. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All three tools follow the same verb_noun pattern: search_articles, get_article_by_link, list_sources. This is perfectly consistent and predictable, making the tool surface easy to navigate.

    Tool Count5/5

    Three tools is well-scoped for a financial news article service. Each tool covers a distinct, necessary operation (search, retrieve by URL, list sources) without redundancy or unnecessary bloat.

    Completeness5/5

    The tool set covers the full lifecycle of accessing articles: discovering sources, searching/filtering articles, and retrieving full details by URL. There are no obvious missing operations for the stated purpose of financial news lookup with sentiment analysis.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that gives any agent real-time news plus the contextual intelligence to use it well — tone distribution, emerging stories, narrative shifts, spike alerts, and tone-over-time charts — powered by Overtone's publisher network. Works with any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Kimi K2, and more.
      7
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Real-time financial news for AI agents and trading bots — AI-enriched stories with per-ticker analysis, a 1–10 relevance score, SEC Form-4 insider transactions, plus trending and "actionable-now" feeds. Free tier, OAuth, no API key to paste.
      2
      11
      3
      MIT