alphavantage stock

stock data, stock analytics

Install

Install and configure the MCP from https://github.com/xweety/alphavantage-stock-mcp now. Follow the repository's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View source on GitHub

README

Alpha Vantage Stock Data MCP Server for Free Tier Account

README Languages: English | 中文

A TypeScript/Node.js implementation of the Model Context Protocol (MCP) server for accessing historical stock market data through the Alpha Vantage API. This server enables LLMs and agentic workflows to seamlessly interact with financial data.

⚠️ Free Account Only This MCP server is specifically designed for Alpha Vantage free tier accounts. It only uses API endpoints available under the free plan. Paid-tier endpoints are not supported.

🚀 Features

Free Tier Compatible: Works entirely within the Alpha Vantage free account limits
Daily Stock Data: Access daily time series data with configurable output sizes
TypeScript: Full TypeScript support with type definitions
MCP Protocol: Compatible with MCP-enabled applications like Claude Desktop, VS Code, and more

📋 Prerequisites

Alpha Vantage free API key

🔑 Getting an API Key

Sign up for a Free Alpha Vantage API key
Copy your API key for Integration with MCP Clients

🔌 Integration with MCP Clients

MCP json Configuration

Add this json configuration:

{
  "mcpServers": {
    "alphavantage-stock-data": {  
      "command": "npx",
      "args": [
        "alphavantage-stock-mcp"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR-ALPHA-VANTAGE-API-KEY"
      }
    }
  }
}

🛠️ Available Tools

get-stock-data

Fetch stock data with a specified symbol and interval. Returns the latest 100 data points.

Parameters:

symbol (required): Stock symbol (e.g., "AAPL", "GOOGL", "MSFT")
interval (optional): Time interval - "daily", "weekly", "monthly" (default: "daily")

Example Usage:

Get the latest weekly data for Apple stock
Symbol: AAPL
Interval: weekly

🤝 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

🙏 Acknowledgments

Alpha Vantage for providing the stock market data API
Model Context Protocol for the protocol specification