README.md•3.52 kB
# Crypto Stocks MCP
An MCP server that tracks real-time data for major crypto-related stocks to help AI agents analyze blockchain investment opportunities.
## Features
- **List Crypto Stocks**: Retrieve a list of crypto-related stocks (e.g., Coinbase, MicroStrategy) in a table format.
- **Real-Time Prices**: Fetch the latest price for a specific stock, including ticker, company name, price, and timestamp.
- **Historical Data**: Access historical stock prices and trading volumes for a specified number of days.
- **Query Prompts**: Generate natural language prompts for querying stock information.
## Installation
### Prerequisites
- Python 3.10 or higher
- [uv](https://docs.astral.sh/uv/) (recommended) or `pip` for dependency management
### Setup
1. **Clone the Repository**:
```bash
git clone https://github.com/kukapay/crypto-stocks-mcp.git
cd crypto-stocks-mcp
```
2. **Install Dependencies**:
Using `uv` (recommended):
```bash
uv sync
```
3. **Install to Claude Desktop**:
Install the server as a Claude Desktop application:
```bash
uv run mcp install main.py --name "Crypto Stocks"
```
Configuration file as a reference:
```json
{
"mcpServers": {
"Crypto Stocks": {
"command": "uv",
"args": [ "--directory", "/path/to/crypto-stocks-mcp", "run", "main.py" ]
}
}
}
```
Replace `/path/to/crypto-stocks-mcp` with your actual installation path.
## Usage
### Example Interactions
Using an MCP-compatible client (e.g., Claude Desktop or MCP Inspector):
- **List All Stocks**:
Prompt:
> Show me all crypto-related stocks.
Result:
```
+----------+-------------------------------------+
| Ticker | Name |
+==========+=====================================+
| COIN | Coinbase Global Inc. |
| MSTR | MicroStrategy Incorporated |
| MARA | Marathon Digital Holdings |
| ... | ... |
+----------+-------------------------------------+
```
- **Get Real-Time Price**:
Prompt:
> What's the latest price for Coinbase?
Result:
```
+----------+-----------------------+---------+----------------------------+
| Ticker | Name | Price | Timestamp |
+==========+=======================+=========+============================+
| COIN | Coinbase Global Inc. | 200.50 | 2025-08-07T17:15:00.123456|
+----------+-----------------------+---------+----------------------------+
```
- **Fetch Historical Data**:
Prompt:
> Show me the historical prices for MicroStrategy over the past 30 days.
Result:
```
+------------+---------+----------+
| Date | Close | Volume |
+============+=========+==========+
| 2025-07-08 | 195.20 | 1200000 |
| 2025-07-09 | 198.50 | 1300000 |
| ... | ... | ... |
+------------+---------+----------+
```
- **Use Query Prompt**:
Call the `stock_query` prompt with `COIN`:
```
Get the latest price and historical data for Coinbase Global Inc. (COIN).
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.