# berlinbra/alpha-vantage-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/berlinbra/alpha-vantage-mcp  
**GitHub Stars:** 104  
**npm Downloads (last month):** 37913  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/berlinbra-alpha-vantage-mcp

## Description
Alpha Vantage API integration to fetch both stock and crypto information

## Tools
Capabilities this server exposes over MCP:

- **get-stock-quote** — Get the latest stock quote for a specific company
- **get-company-info** — Get stock-related information for a specific company
- **get-crypto-exchange-rate** — Get current cryptocurrency exchange rates
- **get-time-series** — Get historical daily price data for a stock
- **get-realtime-options** — Get real-time options chain data with Greeks and implied volatility
- **get-historical-options** — Get historical options chain data with advanced filtering and sorting capabilities
- **get-etf-profile** — Get comprehensive ETF profile information including holdings and sector allocation
- **get-crypto-daily** — Get daily time series data for a cryptocurrency
- **get-crypto-weekly** — Get weekly time series data for a cryptocurrency
- **get-crypto-monthly** — Get monthly time series data for a cryptocurrency
- **get-earnings-calendar** — Get upcoming earnings calendar data for companies
- **get-historical-earnings** — Get historical earnings data for a specific company

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "alpha-vantage-mcp": {
    "command": "npx",
    "args": ["-y","@smithery/cli"],
    "env": {
      "ALPHA_VANTAGE_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `ALPHA_VANTAGE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What berlinbra/alpha-vantage-mcp MCP server does

The berlinbra/alpha-vantage-mcp MCP server exposes twelve Alpha Vantage operations through the Model Context Protocol. Its tools cover current stock quotes, company metadata, cryptocurrency rates and time series, historical stock prices, options chains, ETF profiles, and earnings information.

Stock tools return quote fields such as price, change, volume, high, and low. Company information can include the company name, sector, industry, market capitalization, exchange, currency, and description. The crypto tools support exchange-rate lookups plus daily, weekly, and monthly time series.

For broader market research, the server provides real-time and historical options data, ETF profile information with holdings and sector allocation, upcoming earnings calendars, and historical annual or quarterly earnings reports.

## How it works

The server translates MCP tool calls into requests to the Alpha Vantage API and formats the returned market data for the client. Most tools use a symbol or currency pair as their main input. The stock time-series tool also accepts compact or full output sizing, optional start and end dates in `YYYY-MM-DD` form, and a result limit when date filtering is not used.

The crypto exchange-rate tool accepts a cryptocurrency symbol and a market currency, defaulting to USD. Options requests can specify a contract, choose JSON or CSV output, and request Greeks and implied volatility. Historical options requests support filtering and sorting according to the tool schema. The README also describes built-in error handling and rate-limit management.

## Setup and configuration

An Alpha Vantage API key must be supplied through the `ALPHA_VANTAGE_API_KEY` environment variable. For Claude Desktop, the documented Docker approach builds the repository image with `docker build -t mcp/alpha-vantage .`, then starts it with Docker while passing the environment variable into the container.

The repository also documents a local Python workflow using `uv install -e .` followed by `uv run src/alpha_vantage_mcp/server.py`. Claude Desktop configuration can invoke that local server through `uv`, provided the repository path and API key are set in the configuration. Smithery installation is also documented for Claude Desktop.

## Tools and capabilities

- `get-stock-quote` retrieves the latest quote for a stock symbol.
- `get-company-info` returns company and market details.
- `get-time-series` retrieves historical daily OHLCV data with optional date filtering.
- `get-crypto-exchange-rate` returns a crypto-to-fiat or crypto-to-market-currency rate with bid and ask data.
- `get-crypto-daily`, `get-crypto-weekly`, and `get-crypto-monthly` retrieve crypto time series at different intervals.
- `get-realtime-options` returns current options-chain data and can include Greeks and implied volatility.
- `get-historical-options` retrieves historical options chains with filtering and sorting.
- `get-etf-profile` returns ETF holdings, sector allocation, and related profile data.
- `get-earnings-calendar` returns upcoming earnings information with configurable time horizons.
- `get-historical-earnings` returns historical earnings reports.

## Limitations and notes

The berlinbra/alpha-vantage-mcp MCP server depends on Alpha Vantage availability, API limits, and the permissions associated with the supplied key. Real-time options data requires an Alpha Vantage Premium subscription with either the 600- or 1,200-requests-per-minute plan. Free accounts and the standard 75-requests-per-minute plan return placeholder or demo data for that endpoint; the README identifies historical options as an alternative available across API key tiers.

The documentation provides client setup instructions for Claude Desktop. It does not establish compatibility with other MCP clients. The server supplies market data; the material does not describe trading, order execution, portfolio management, or investment advice features.

_Full upstream README: https://allmcps.com/mcp/berlinbra-alpha-vantage-mcp/readme_