Crypto Stocks MCP

1# Crypto Stocks MCP
2 
3An MCP server that tracks real-time data for major crypto-related stocks to help AI agents analyze blockchain investment opportunities.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/crypto-stocks-mcp) 
6![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **List Crypto Stocks**: Retrieve a list of crypto-related stocks (e.g., Coinbase, MicroStrategy) in a table format.
12- **Real-Time Prices**: Fetch the latest price for a specific stock, including ticker, company name, price, and timestamp.
13- **Historical Data**: Access historical stock prices and trading volumes for a specified number of days.
14- **Query Prompts**: Generate natural language prompts for querying stock information.
15 
16## Installation
17 
18### Prerequisites
19 
20- Python 3.10 or higher
21- [uv](https://docs.astral.sh/uv/) (recommended) or `pip` for dependency management
22 
23### Setup
24 
251. **Clone the Repository**:
26 
27   ```bash
28   git clone https://github.com/kukapay/crypto-stocks-mcp.git
29   cd crypto-stocks-mcp
30   ```
31 
322. **Install Dependencies**:
33 
34   Using `uv` (recommended):
35 
36   ```bash
37   uv sync
38   ```
39   
403. **Install to Claude Desktop**:
41 
42    Install the server as a Claude Desktop application:
43    ```bash
44    uv run mcp install main.py --name "Crypto Stocks"
45    ```
46 
47    Configuration file as a reference:
48 
49    ```json
50    {
51       "mcpServers": {
52           "Crypto Stocks": {
53               "command": "uv",
54               "args": [ "--directory", "/path/to/crypto-stocks-mcp", "run", "main.py" ]
55           }
56       }
57    }
58    ```
59    Replace `/path/to/crypto-stocks-mcp` with your actual installation path.
60   
61## Usage
62 
63### Example Interactions
64 
65Using an MCP-compatible client (e.g., Claude Desktop or MCP Inspector):
66 
67- **List All Stocks**:
68 
69  Prompt:
70  > Show me all crypto-related stocks.
71 
72  Result:
73  ```
74  +----------+-------------------------------------+
75  | Ticker   | Name                                |
76  +==========+=====================================+
77  | COIN     | Coinbase Global Inc.                |
78  | MSTR     | MicroStrategy Incorporated          |
79  | MARA     | Marathon Digital Holdings           |
80  | ...      | ...                                 |
81  +----------+-------------------------------------+
82  ```
83 
84- **Get Real-Time Price**:
85 
86  Prompt:
87  > What's the latest price for Coinbase?
88 
89  Result:
90  ```
91  +----------+-----------------------+---------+----------------------------+
92  | Ticker   | Name                  | Price   | Timestamp                  |
93  +==========+=======================+=========+============================+
94  | COIN     | Coinbase Global Inc.  | 200.50  | 2025-08-07T17:15:00.123456|
95  +----------+-----------------------+---------+----------------------------+
96  ```
97 
98- **Fetch Historical Data**:
99 
100  Prompt:
101  > Show me the historical prices for MicroStrategy over the past 30 days.
102  
103  Result:
104  ```
105  +------------+---------+----------+
106  | Date       | Close   | Volume   |
107  +============+=========+==========+
108  | 2025-07-08 | 195.20  | 1200000  |
109  | 2025-07-09 | 198.50  | 1300000  |
110  | ...        | ...     | ...      |
111  +------------+---------+----------+
112  ```
113 
114- **Use Query Prompt**:
115 
116  Call the `stock_query` prompt with `COIN`:
117 
118  ```
119  Get the latest price and historical data for Coinbase Global Inc. (COIN).
120  ```
121 
122 
123## License
124 
125This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
126 
127