# Price Service MCP

A Model Context Protocol (MCP) server that provides cryptocurrency price data retrieval capabilities. This server connects to BitwaveCorp's price service API to fetch real-time and historical cryptocurrency prices.

## Features

- **get_price**: Fetch cryptocurrency price data with customizable parameters
- **health_check**: Check the health status of the price service
- Support for multiple exchanges (Coinbase, Binance, Kraken)
- Historical price data with timestamp support
- Multiple time resolutions (1m, 5m, 15m, 1h, 4h, 1d)
- Configurable fiat currency conversion

## Installation

```bash
npm install
npm run build
```

## Usage

### Development
```bash
npm run dev
```

### Production
```bash
npm run build
npm start
```

## Tools

### get_price

Retrieve cryptocurrency price data from the price service.

**Parameters:**
- `fromSym` (required): Cryptocurrency symbol (e.g., "BTC", "ETH")
- `timestampSEC` (optional): Unix timestamp in seconds for historical price
- `service` (optional): Price service to use ("coinbase", "binance", "kraken") - default: "coinbase"
- `resolution` (optional): Time resolution ("1m", "5m", "15m", "1h", "4h", "1d") - default: "1d"
- `toFiat` (optional): Target fiat currency - default: "USD"
- `timezone` (optional): Timezone for timestamp - default: "UTC"

**Example:**
```json
{
  "fromSym": "BTC",
  "service": "coinbase",
  "toFiat": "USD"
}
```

### health_check

Check the health status of both the MCP server and the underlying price service.

**Parameters:** None

## Configuration for Claude Desktop

Add this to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "price-service": {
      "command": "node",
      "args": ["/path/to/price-service-mcp/build/index.js"]
    }
  }
}
```

## API Endpoint

The MCP server connects to: `https://price-svc-utyjy373hq-uc.a.run.app`

## Development

1. Clone the repository
2. Install dependencies: `npm install`
3. Build the project: `npm run build`
4. Run in development mode: `npm run dev`

## License

MIT

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.