{
  "markdown": "# finlight MCP Server\n\n*English | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)*\n\n`mcp-name: me.finlight/news`\n\n[![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)\n\nReal-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.\n\n**Endpoint:** `https://mcp.finlight.me` (remote, streamable HTTP)\n**Auth:** OAuth 2.0 (you'll be prompted for your finlight API key during connection)\n**Registry:** `me.finlight/news`\n\n## What you can do\n\nAsk your AI assistant things like:\n\n- \"What's the latest news on NVDA? Summarize sentiment.\"\n- \"Any market-moving headlines in the last 2 hours?\"\n- \"Compare news coverage of the Fed decision across sources.\"\n- \"Find recent articles about semiconductor export restrictions and list the companies mentioned.\"\n- \"Which sources does finlight cover for Chinese market news?\"\n\n## Tools\n\n| Tool                  | Description                                                                                                                                                                                  |\n| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `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. |\n| `get_article_by_link` | Retrieve a specific article by its URL, including full enrichment (sentiment, confidence, tagged companies with tickers and ISINs).                                                          |\n| `list_sources`        | List all available news sources with country of origin and content availability.                                                                                                             |\n\n## Setup\n\nYou 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.\n\n### Claude (web / desktop)\n\n1. Go to **Settings → Connectors → Add custom connector**\n2. Enter `https://mcp.finlight.me`\n3. Complete the OAuth flow: you'll be asked to paste your finlight API key once\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http finlight https://mcp.finlight.me\n```\n\n### Cursor\n\nAdd to your MCP settings (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"finlight\": {\n      \"url\": \"https://mcp.finlight.me\"\n    }\n  }\n}\n```\n\n### ChatGPT (developer mode / connectors)\n\nAdd `https://mcp.finlight.me` as a remote MCP server and complete the OAuth flow with your API key.\n\n### Stdio / local usage\n\nFor MCP clients that only support stdio transport (or if you prefer a locally spawned process), use the npm wrapper:\n\n```bash\nnpx finlight-mcp\n```\n\nThis bridges stdio to the remote server via `mcp-remote`. Add it to any client config that takes a command + args:\n\n```json\n{\n  \"mcpServers\": {\n    \"finlight\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"finlight-mcp\"]\n    }\n  }\n}\n```\n\nThe OAuth flow is the same — a browser window will open for you to enter your API key on first use.\n\nFor headless or CI environments where no browser is available, set `FINLIGHT_API_KEY` to skip OAuth and authenticate directly:\n\n```json\n{\n  \"mcpServers\": {\n    \"finlight\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"finlight-mcp\"],\n      \"env\": {\n        \"FINLIGHT_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## How auth works\n\nThe server supports two authentication methods:\n\n1. **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.\n2. **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.\n\n## About the data\n\nfinlight 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:\n\n- Sentiment score with confidence\n- Tagged company entities with tickers, ISINs, and exchange listings\n- Source, language, country, and publish metadata\n\nThe MCP server uses the same data as the [REST and WebSocket APIs](https://docs.finlight.me).\n\n## Rate limits and plans\n\nMCP 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.\n\n## Links\n\n- Website: [finlight.me](https://finlight.me)\n- MCP landing page: [finlight.me/mcp](https://finlight.me/mcp)\n- API docs: [docs.finlight.me](https://docs.finlight.me)\n- Discord: [discord.gg/XUs9JYZd24](https://discord.com/invite/XUs9JYZd24)\n- Support: support via [app.finlight.me](https://app.finlight.me) or Discord\n\n## Feedback\n\nIssues and feature requests for the MCP server are welcome here on GitHub. For API questions, use Discord or the support channels above.\n",
  "bytes": 5629,
  "sha": "c067d2718bb6d24102f3bccabfeb6add5ef35e03a7a5acb84f8ea312774a5d27",
  "repo_slug": "callbk/finlight-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_me_finlight_news_403f117c/readme"
}