# finlight MCP Server

*English | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)*

`mcp-name: me.finlight/news`

[![smithery badge](https://smithery.ai/badge/callbk/finlight)](https://smithery.ai/servers/callbk/finlight) [![finlight-mcp MCP server](https://glama.ai/mcp/servers/callbk/finlight-mcp/badges/score.svg)](https://glama.ai/mcp/servers/callbk/finlight-mcp) [![npm](https://img.shields.io/npm/v/finlight-mcp)](https://www.npmjs.com/package/finlight-mcp)

Real-time financial news for AI agents. Connect Claude, ChatGPT, Cursor, or any MCP client to [finlight](https://finlight.me), 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?"

## 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](https://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

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

### Cursor

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

```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:

```bash
npx finlight-mcp
```

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

```json
{
  "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:

```json
{
  "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](https://docs.finlight.me).

## Rate limits and plans

MCP requests count toward your API quota. See [pricing](https://finlight.me/pricing) for the current free-tier limit and for paid tiers with real-time access, higher limits, and additional features.

## Links

- Website: [finlight.me](https://finlight.me)
- MCP landing page: [finlight.me/mcp](https://finlight.me/mcp)
- API docs: [docs.finlight.me](https://docs.finlight.me)
- Discord: [discord.gg/XUs9JYZd24](https://discord.com/invite/XUs9JYZd24)
- Support: support via [app.finlight.me](https://app.finlight.me) or Discord

## Feedback

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