Skip to main content
Glama

Yahoo Finance MCP Server

by sdpa
GitHub
TypeScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Yahoo Finance MCP Server

A Model Context Protocol (MCP) server that provides real-time stock data, historical prices, news, and comparison features using Yahoo Finance data. Built following Dedalus Labs server guidelines with streamable HTTP transport as the primary method.

Features

  • Real-time Quotes: Get current stock prices and market data

  • Historical Data: Retrieve OHLCV data for any time range

  • News: Fetch latest news headlines for any ticker

  • Comparison: Compare multiple stocks side by side

  • Streamable HTTP Transport: Modern HTTP transport for production deployment

  • STDIO Transport: Development-friendly transport for local testing

  • Session Management: Proper session handling for HTTP connections

  • Health Checks: Built-in health monitoring endpoints

Architecture

This server follows the Dedalus Labs MCP Server Guidelines with:

  • Modular Architecture: Clear separation of concerns with dedicated modules

  • Streamable HTTP First: Modern HTTP transport as the primary interface

  • Type Safety: Full TypeScript coverage with proper interfaces

  • Production Ready: Built-in error handling, logging, and configuration management

  • Testable: Dependency injection and isolated components

Directory Structure

src/ ├── index.ts # Main entry point ├── cli.ts # Command-line argument parsing ├── config.ts # Configuration management ├── server.ts # Server instance creation ├── client.ts # External API client (Yahoo Finance) ├── yahoo-finance-service.ts # Service layer ├── types.ts # TypeScript type definitions ├── tools/ │ ├── index.ts # Tool exports │ └── yahoo-finance.ts # Tool definitions and handlers └── transport/ ├── index.ts # Transport exports ├── http.ts # HTTP transport (primary) └── stdio.ts # STDIO transport (development)

MCP Tools

1. get_quote

Get current price and market snapshot for a stock.

Parameters:

  • ticker (string, required): Stock ticker symbol (e.g., AAPL, GOOGL, MSFT)

Example:

{ "ticker": "AAPL" }

Response:

{ "ticker": "AAPL", "price": 150.25, "change": 2.15, "changePercent": 1.45, "volume": 45000000, "marketCap": 2500000000000, "pe": 25.5, "high52Week": 180.00, "low52Week": 120.00, "open": 148.50, "previousClose": 148.10, "timestamp": "2024-01-15T10:30:00.000Z" }

2. get_historical_data

Get historical OHLCV data for a stock.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • range (string, optional): Time range - 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max (default: 1mo)

  • interval (string, optional): Data interval - 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo (default: 1d)

3. get_news

Get latest news headlines for a stock.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • limit (number, optional): Number of news items (1-50, default: 5)

4. compare_stocks

Compare multiple stocks side by side.

Parameters:

  • tickers (array, required): Array of stock ticker symbols (2-10 tickers)

Installation

  1. Clone the repository:

git clone <repository-url> cd yahoo-finance-mcp

  1. Install dependencies:

npm install

  1. Build the project:

npm run build

Usage

STDIO Transport (Development)

For local development and testing:

# List available tools echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | npm run start:stdio # Get Apple stock quote echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "get_quote", "arguments": {"ticker": "AAPL"}}}' | npm run start:stdio # Compare multiple stocks echo '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "compare_stocks", "arguments": {"tickers": ["AAPL", "GOOGL", "MSFT"]}}}' | npm run start:stdio

HTTP Transport (Production)

For production deployment with streamable HTTP:

# Start HTTP server npm start # Health check curl http://localhost:8080/health # The server supports both: # - /mcp endpoint for streamable HTTP transport # - /sse endpoint for SSE transport (backward compatibility)

Command Line Options

# Run with custom port npm start -- --port 3000 # Force STDIO transport npm run start:stdio # Show help npm start -- --help

Configuration

Environment Variables

  • PORT: HTTP server port (default: 8080)

  • NODE_ENV: Set to 'production' for production mode

Client Configuration

For MCP clients, use this configuration:

{ "mcpServers": { "yahoo-finance": { "url": "http://localhost:8080/mcp" } } }

For backward compatibility with SSE:

{ "mcpServers": { "yahoo-finance": { "url": "http://localhost:8080/sse" } } }

Testing

Run Comprehensive Tests

# Test both transports node test-dedalus-mcp.js # Test individual tools echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | npm run start:stdio

Health Monitoring

# Check server health curl http://localhost:8080/health # Expected response: { "status": "healthy", "timestamp": "2024-01-15T10:30:00.000Z", "service": "yahoo-finance-mcp", "version": "0.2.0" }

Development

Available Scripts

  • npm run build: Compile TypeScript to JavaScript

  • npm run watch: Watch mode for development

  • npm start: Start HTTP server

  • npm run start:stdio: Start STDIO server

  • npm run dev: Build and start HTTP server

  • npm run dev:stdio: Build and start STDIO server

Project Structure

The server follows the Dedalus Labs guidelines with:

  • Modular Design: Each component has a specific responsibility

  • Transport Abstraction: Easy switching between HTTP and STDIO

  • Configuration Management: Environment-based configuration

  • Error Handling: Comprehensive error handling throughout

  • Type Safety: Full TypeScript coverage

Production Deployment

Docker Deployment

FROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY dist/ ./dist/ EXPOSE 8080 CMD ["node", "dist/index.js"]

Environment Setup

# Production environment export NODE_ENV=production export PORT=8080 npm start

Dependencies

  • @modelcontextprotocol/sdk: Official MCP SDK (v1.17.3+)

  • yahoo-finance2: Yahoo Finance API client

  • dotenv: Environment variable management

License

MIT License

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes following the Dedalus Labs guidelines

  4. Add tests if applicable

  5. Submit a pull request

Support

For issues and questions, please open an issue on the GitHub repository.

References

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides real-time stock quotes, historical price data, financial news, and multi-stock comparisons using Yahoo Finance data. Enables users to access comprehensive financial market information through natural language queries.

  1. Features
    1. Architecture
      1. Directory Structure
    2. MCP Tools
      1. 1. get_quote
      2. 2. get_historical_data
      3. 3. get_news
      4. 4. compare_stocks
    3. Installation
      1. Usage
        1. STDIO Transport (Development)
        2. HTTP Transport (Production)
        3. Command Line Options
      2. Configuration
        1. Environment Variables
        2. Client Configuration
      3. Testing
        1. Run Comprehensive Tests
        2. Health Monitoring
      4. Development
        1. Available Scripts
        2. Project Structure
      5. Production Deployment
        1. Docker Deployment
        2. Environment Setup
      6. Dependencies
        1. License
          1. Contributing
            1. Support
              1. References

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/sdpa/yahoo-finance-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server