# Alpha Vantage MCP Server 📈
[![smithery badge](https://smithery.ai/badge/@deepsuthar496/alpha-ventage-mcp)](https://smithery.ai/server/@deepsuthar496/alpha-ventage-mcp)

A Model Context Protocol (MCP) server that provides seamless integration with Alpha Vantage's financial data API, enabling real-time stock market data, cryptocurrency prices, forex rates, and technical indicators.

## 🌟 Features

### Stock Market Data
- Real-time stock quotes from global markets
- Historical price data (daily, weekly)
- Comprehensive company information
- Support for multiple exchanges (NYSE, NASDAQ, BSE)

### Cryptocurrency Data
- Real-time crypto prices
- Digital currency exchange rates
- Major cryptocurrency market data

### Forex Trading
- Live foreign exchange rates
- Currency pair conversions
- Global forex market data

### Technical Analysis
- Advanced technical indicators
- Moving averages (SMA, EMA)
- Market momentum indicators
- Trading signals and patterns

## 🚀 Quick Start

### Installation

#### Installing via Smithery

To install Alpha Vantage Financial Data Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@deepsuthar496/alpha-ventage-mcp):

```bash
npx -y @smithery/cli install @deepsuthar496/alpha-ventage-mcp --client claude
```

### Manual Installation [Administered by Repo Owner]

1. Clone the repository:
```bash
git clone https://github.com/deepsuthar496/alpha-ventage-mcp
cd alpha-vantage-server
```

2. Install dependencies:
```bash
npm install
```

3. Build the server:
```bash
npm run build
```

### Configuration

Configure the server in your MCP settings file:

```json
{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["path/to/alpha-vantage-server/build/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}
```

## 🛠️ Available Tools

### Stock Market Tools

#### get_stock_price
```typescript
// Get real-time stock quotes
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_stock_price</tool_name>
<arguments>
{
  "symbol": "AAPL" 
}
</arguments>
</use_mcp_tool>
```

#### get_daily_time_series
```typescript
// Get daily stock price history
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_daily_time_series</tool_name>
<arguments>
{
  "symbol": "MSFT",
  "outputsize": "compact"
}
</arguments>
</use_mcp_tool>
```

### Cryptocurrency Tools

#### get_crypto_price
```typescript
// Get cryptocurrency prices
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_crypto_price</tool_name>
<arguments>
{
  "symbol": "BTC",
  "market": "USD"
}
</arguments>
</use_mcp_tool>
```

### Forex Tools

#### get_forex_rate
```typescript
// Get currency exchange rates
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_forex_rate</tool_name>
<arguments>
{
  "from_currency": "USD",
  "to_currency": "EUR"
}
</arguments>
</use_mcp_tool>
```

## 📊 Technical Analysis

### get_technical_indicator
```typescript
// Get technical indicators
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_technical_indicator</tool_name>
<arguments>
{
  "symbol": "AAPL",
  "indicator": "SMA",
  "interval": "daily"
}
</arguments>
</use_mcp_tool>
```

## 🔑 API Key

Sign up for an API key at [Alpha Vantage](https://www.alphavantage.co/support/#api-key). Free tier includes:
- 25 API calls per day
- Real-time and historical data access
- Global market coverage

## 🌐 Supported Markets

- US Stock Markets (NYSE, NASDAQ)
- Global Cryptocurrency Markets
- Foreign Exchange Markets
- International Stock Markets

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

## 📝 License

MIT