Back to Discover

finlight-mcp

connector

callbk

Real-time financial news for AI agents: search by ticker and source, with sentiment and entities.

View on GitHub
0 starsSynced Aug 7, 2026

Install to Claude Code

/plugin marketplace add callbk/finlight-mcp

README

finlight MCP Server

mcp-name: me.finlight/news

smithery badge 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 from Reuters 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?"

Tools

ToolDescription
search_articlesSearch 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_linkRetrieve a specific article by its URL, including full enrichment (sentiment, confidence, tagged companies with tickers and ISINs).
list_sourcesList all available news sources with country of origin and content availability.

Setup

You need a finlight API key. The free tier includes 5,000 requests per month: sign up at app.finlight.me.

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 (including Chinese-language financial media such as CLS, Caixin, Yicai, and East Money, 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. Free tier: 5,000 requests/month. See pricing for paid tiers with real-time access, higher limits, and additional features.

Links

Feedback

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

Rendered live from callbk/finlight-mcp's GitHub README — not stored, always reflects the source repo.

2 Install Methods

NameDescriptionCategorySource
npm packageInstall via npm (stdio transport)mcp-serverfinlight-mcp
streamable-http remoteHosted streamable-http endpointmcp-serverhttps://mcp.finlight.me

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.