omega-suite/omega-free-finance-server

🏦 About OMEGA Suite

OMEGA Suite is a comprehensive collection of professional-grade financial tools designed for AI assistants. Our mission is to democratize access to financial data and analysis tools, making them freely available to everyone.

🌟 Why Choose OMEGA Suite?

• 100% Free & Open Source - No hidden costs, no premium tiers
• Professional Grade - Used by traders, analysts, and financial institutions
• AI-Native - Built specifically for LLM integration via MCP protocol
• Comprehensive - Complete suite of financial analysis tools
• Community Driven - Continuously improved by the open-source community

Visit osuite.finance to explore our full suite of tools.

📊 OMEGA Free Finance Server

An open-source Model Context Protocol (MCP) server that provides free access to real-time financial data for AI assistants like Claude. Built as a free alternative to premium financial data APIs.

Powered by Yahoo Finance - No API keys required, completely free to use.

Features

• 100% Free: No API keys required - powered by Yahoo Finance's open data
• Real-time Data: Live stock quotes, market data, and financial information
• Comprehensive Coverage: Stocks, ETFs, mutual funds, cryptocurrencies, forex, and more
• AI-Native: Built specifically for LLM interaction via MCP protocol
• Zero Configuration: Works out of the box without any setup

Available Tools

Market Data

• get_quote - Real-time stock quotes with price, volume, market cap
• get_multiple_quotes - Batch quotes for multiple symbols
• get_historical_data - Historical price data with customizable intervals
• get_trending - Trending stocks by region
• run_screener - Pre-built screeners (gainers, losers, most active)

Company Information

• get_company_profile - Company description, sector, employees, etc.
• get_financials - Income statements, balance sheets, cash flow
• get_recommendations - Analyst ratings and price targets
• get_insights - AI-powered insights and analysis

Advanced Features

• get_options - Options chain data
• search_symbols - Search for stocks by name or ticker

Installation

Quick Start (via npm)

# Install globally
npm install -g @omega-suite/free-finance-server

# Or run directly with npx
npx @omega-suite/free-finance-server

From Source

# Clone the repository
git clone https://github.com/omega-suite/free-finance-server.git
cd free-finance-server

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm start

Configuration for Claude Desktop

Add this to your Claude Desktop configuration file:

MacOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "omega-free": {
      "command": "npx",
      "args": ["@omega-suite/free-finance-server"]
    }
  }
}

Or if running from source:

{
  "mcpServers": {
    "omega-free": {
      "command": "node",
      "args": ["/path/to/free-finance-server/dist/index.js"]
    }
  }
}

Usage Examples

Once configured, you can ask Claude:

• "Get me the current price of Apple stock"
• "Show me Tesla's financial statements"
• "What are the top gaining stocks today?"
• "Get historical prices for Microsoft for the last 3 months"
• "Search for electric vehicle stocks"
• "Show me analyst recommendations for NVDA"

Development

Testing

# Run tests
npm test

# Run in development mode
npm run dev

Building

# Build TypeScript to JavaScript
npm run build

Limitations

• Rate limits may apply from Yahoo Finance (usually generous for personal use)
• Some data might be delayed by 15-20 minutes for certain exchanges
• Options data only available for US stocks
• Financial statements might not be available for all international stocks

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the file for details.

Disclaimer

This tool is for educational and personal use. Always verify financial data from multiple sources before making investment decisions. The authors are not responsible for any financial losses incurred from using this tool.

Comparison with Premium Alternatives

🛠️ Other OMEGA Suite Tools

Explore our complete suite of financial tools:

• OMEGA PyPortfolioOpt - Advanced portfolio optimization
• OMEGA Value Investing - Warren Buffett-style analysis
• OMEGA Fama-French - Factor analysis and modeling
• OMEGA Economic Regimes - Market regime detection
• OMEGA Financial Context - Comprehensive market context

Visit osuite.finance for documentation and tutorials.

📧 Support

• Documentation: docs.osuite.finance
• Community Forum: community.osuite.finance
• GitHub Issues: Open an issue
• Email: support@osuite.finance

🙏 Acknowledgments

• Powered by Yahoo Finance via yahoo-finance2
• Uses Anthropic's Model Context Protocol
• Part of the OMEGA Suite ecosystem

📄 License

This project is licensed under the MIT License - see the file for details.