article

README

Financial Data - 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.

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:

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

Manual Installation

npm install findata-mcp-server

Usage in Host

Obtain an API key from Alpha Vantage https://www.alphavantage.co/support/#api-key.
Configure your MCP client (e.g., Claude Desktop) to connect to the server:

{
  "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

findata-mcp-server