jvenkatasandeep/finance-news-mcp

Finance News RSS MCP Server

A Model Context Protocol (MCP) server that provides real-time finance news from major RSS feeds. Built with FastMCP to demonstrate MCP basics.

What This MCP Does

This MCP server gives Claude access to finance news from major sources including:

• Bloomberg
• Wall Street Journal (WSJ)
• CNBC
• Seeking Alpha
• MarketWatch
• Financial Times

The server provides two tools:

1. get_latest_finance_news - Fetch the latest news from all sources or a specific source
2. search_finance_news - Search across all feeds for articles matching a keyword

Installation

Install dependencies using uv:

uv sync

How to Run

Start the MCP server:

uv run python main.py

Or configure it in your Claude Desktop app by adding to your MCP settings:

{
  "mcpServers": {
    "finance-news": {
      "command": "uv",
      "args": ["--directory", "/path/to/example", "run", "python", "main.py"]
    }
  }
}

Important Notes:

• Replace /path/to/example with the actual path to your project directory
• If you get a "spawn uv ENOENT" error, use the full path to uv:
  • Find it with: which uv
  • Common locations: ~/.local/bin/uv or ~/.cargo/bin/uv
  • Update command to the full path, e.g., "/Users/yourname/.local/bin/uv"

Example Questions to Ask Claude

Once connected, you can ask Claude questions like:

• "What are the latest finance news headlines?"
• "Get me the top 5 news articles from Bloomberg"
• "Search for news about 'inflation' in finance feeds"
• "What's the latest news from CNBC?"
• "Find articles about 'Federal Reserve' or 'interest rates'"
• "Show me recent Yahoo Finance headlines"

Available Tools

get_latest_finance_news

Fetch the latest finance news articles.

Parameters:

• limit (int, default=10): Maximum number of articles to return
• source (str, default="all"): News source to fetch from
  • Options: "all", "bloomberg", "wsj", "cnbc", "seekingalpha", "marketwatch", "ft"

Example:

get_latest_finance_news(limit=5, source="wsj")

search_finance_news

Search for articles matching a keyword across all feeds.

Parameters:

• query (str, required): Search keyword to find in titles or descriptions
• limit (int, default=10): Maximum number of matching articles to return

Example:

search_finance_news(query="bitcoin", limit=5)

Implementation Details

• No caching: Fetches RSS feeds on-demand for real-time updates
• Error handling: Gracefully skips feeds that fail to load
• Simple & clean: Single-file implementation, perfect portfolio piece
• Dependencies: fastmcp, feedparser, httpx

Project Structure

example/
├── main.py             # MCP server implementation
├── pyproject.toml      # Project dependencies
├── uv.lock             # Dependency lock file
└── README.md           # This file

How It Works

The server uses:

• FastMCP to create the MCP server and register tools
• httpx to fetch RSS feed URLs
• feedparser to parse RSS/Atom feeds into structured data

Each tool fetches feeds in real-time, parses them, and returns structured article data including title, link, published date, description, and source name.

License

MIT