mcpField
A
Alphavantage Stock Mcp

Alphavantage Stock Mcp

Local
github.com/xweetyFinance1Updated 26w ago
Repository

About Alphavantage Stock Mcp

A TypeScript and Node.js MCP server that retrieves historical stock data from Alpha Vantage using endpoints available to free-tier accounts. It is intended for LLMs and agent workflows that need daily, weekly, or monthly time series.

Key features

  1. 01Free-tier API endpoint support
  2. 02Daily, weekly, and monthly data
  3. 03Configurable stock symbol and interval
  4. 04Returns up to 100 data points
  5. 05TypeScript implementation

Use cases

  1. 01Retrieve recent data for a stock symbol
  2. 02Inspect weekly or monthly price history
  3. 03Provide market time series to an agent workflow

MCP support

The server exposes a get-stock-data tool to MCP clients. It requires an Alpha Vantage free API key and uses endpoints available on the free plan.

#stock#financial-data#api

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "alphavantage-stock": {
      "command": "npx",
      "args": [
        "-y",
        "alphavantage-stock-mcp"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "<ALPHAVANTAGE_API_KEY>"
      }
    }
  }
}
Run commandnpx -y alphavantage-stock-mcp
Environment variables to set
ALPHAVANTAGE_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmalphavantage-stock-mcp

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
symbolstringYesStock symbol (e.g., IBM, AAPL)
intervalenumNoTime interval between data points by daily or weekly or monthly (default: daily)daily | weekly | monthly

Details

From the project README

Alpha Vantage Stock Data MCP Server for Free Tier Account

README Languages: English | 中文

NPM Version License: MIT

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

  1. Sign up for a Free Alpha Vantage API key
  2. 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:

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

🙏 Acknowledgments

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.