Alpha Vantage

Access Alpha Vantage financial data APIs to get real-time and historical stock data, forex rates, and cryptocurrency information.

A Model Context Protocol (MCP) server that provides access to Alpha Vantage financial data APIs for use with Claude Desktop and other MCP-compatible applications.

- Stock Data: Real-time quotes and historical daily prices
- Financial Statements: Income statements, balance sheets, and cash flow statements
- Company Information: Company overviews and earnings data
- News & Sentiment: Latest financial news with sentiment analysis
- Error Handling: Robust API error handling and rate limit management
- Alpha Vantage API Key: Get your free API key fromAlpha Vantage
- Python 3.8+: Make sure you have Python installed
- Claude Desktop: Or another MCP-compatible application

git clone https://github.com/yourusername/alphavantage-mcp-server.git cd alphavantage-mcp-server

- VisitAlpha Vantage
- Sign up for a free account
- Copy your API key

{ "mcpServers": { "alphavantage": { "command": "python3", "args": ["/path/to/alphavantage_server.py"], "env": { "ALPHAVANTAGE_API_KEY": "your_actual_api_key_here" } } } }

Important: Replace/path/to/alphavantage_server.pywith the actual path to your script andyour_actual_api_key_herewith your Alpha Vantage API key.

- "Get the current stock quote for Apple (AAPL)"
- "Show me Microsoft's latest income statement"
- "What's the latest news about Tesla stock?"
- "Get Amazon's balance sheet data"
- "Show me Google's cash flow statement"

Test your installation by running the server directly:

export ALPHAVANTAGE_API_KEY="your_api_key" python3 alphavantage_server.py

The server should start without errors. PressCtrl+Cto stop.

- Free Tier: 25 requests/day for premium endpoints, 500 requests/day for standard endpoints
- Rate Limit: 5 calls/minute
- Premium Tiers: Available for higher limits

- Check that your API key is correct
- Verify the file path in your config
- Ensure dependencies are installed

"ModuleNotFoundError: No module named 'mcp'"

- Install dependencies:pip install -r requirements.txt
- Use the correct Python path in your config

- You've exceeded the free tier limits
- Wait for the rate limit to reset or upgrade your plan
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

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

- Alpha Vantagefor providing the financial data API
- Anthropicfor creating the Model Context Protocol
- The MCP community for tools and documentation

If you encounter any issues or have questions:
- Check thetroubleshooting section
- Search existingGitHub issues
- Create a new issue with detailed information about your problem

Full-lifecycle algorithmic trading: describe strategies in plain English, AI generates code, backtest on real data, deploy live to 10+ brokers. Stocks, options, crypto, futures. Free tier available.