[![Add to Cursor](https://fastmcp.me/badges/cursor_dark.svg)](https://fastmcp.me/MCP/Details/625/alpha-vantage-financial-data)
[![Add to VS Code](https://fastmcp.me/badges/vscode_dark.svg)](https://fastmcp.me/MCP/Details/625/alpha-vantage-financial-data)
[![Add to Claude](https://fastmcp.me/badges/claude_dark.svg)](https://fastmcp.me/MCP/Details/625/alpha-vantage-financial-data)
[![Add to ChatGPT](https://fastmcp.me/badges/chatgpt_dark.svg)](https://fastmcp.me/MCP/Details/625/alpha-vantage-financial-data)
[![Add to Codex](https://fastmcp.me/badges/codex_dark.svg)](https://fastmcp.me/MCP/Details/625/alpha-vantage-financial-data)
[![Add to Gemini](https://fastmcp.me/badges/gemini_dark.svg)](https://fastmcp.me/MCP/Details/625/alpha-vantage-financial-data)

# Financial Data - MCP Server

[![smithery badge](https://smithery.ai/badge/findata-mcp-server)](https://smithery.ai/server/findata-mcp-server)

This is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.

<a href="https://glama.ai/mcp/servers/czslwc47w9"><img width="380" height="200" src="https://glama.ai/mcp/servers/czslwc47w9/badge" alt="findata-mcp-server MCP server" /></a>

## Available Features

*   `getStockQuote`: Get the current quote for a stock.
*   `getHistoricalData`: Get historical data for a stock (daily, weekly, or monthly).
*   (More tools will be added later for technical analysis, company overview, etc.)

## Setup

### Installing via Smithery

To install Financial Data Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/findata-mcp-server):

```bash
npx -y @smithery/cli install findata-mcp-server --client claude
```

### Manual Installation
```bash
npm install findata-mcp-server
```

## Usage in Host
1. Obtain an API key from Alpha Vantage https://www.alphavantage.co/support/#api-key.


2. Configure your MCP client (e.g., Claude Desktop) to connect to the server:

```JSON
{
  "mcpServers": {
    "alphaVantage": {
      "command": "npx",
      "args": ["-y", "findata-mcp-server"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "PUT_YOUR_API_KEY_HERE"
      }
    }
  }
}
```

## Tools
### `getStockQuote`
Get the current quote for a stock.

Input:

`symbol`: The stock symbol (e.g., AAPL)
Output Example:


### `getHistoricalData`
Get historical data for a stock.

Input:

- `symbol`: the stock symbol (e.g., AAPL)
- `interval`: the time interval for the data (`daily`, `weekly`, or `monthly`) (optional, default: `daily`)
- `outputsize`: the size of the output (`compact` or `full`) (optional, default: `compact`)
Output:

JSON object containing the historical data. The structure of the output depends on the interval parameter.

## Contributing
Contributions are welcome! Please open an issue or pull request.


### License
MIT