crypto-stocks-mcp

crypto-stocks-mcp is an MCP (Model Context Protocol) server designed to track real-time data on major cryptocurrency-related stocks to help AI agents analyze blockchain investment opportunities.

Main Capabilities

• List crypto stocks: Retrieve a list of cryptocurrency-related stocks in table form (e.g., Coinbase, MicroStrategy).
• Real-time prices: Get the latest price of a specific stock, including ticker symbol, company name, price, and timestamp.
• Historical data: Access historical stock prices and trading volume for a specified number of days.
• Query prompts: Generate natural language prompts for querying stock information.

Usage

Requirements

• Python 3.10 or higher
• uv (recommended) or pip for dependency management

Installation Steps

1. Clone the repository:

   git clone https://github.com/kukapay/crypto-stocks-mcp.git
   cd crypto-stocks-mcp
   

2. Install dependencies: Using uv (recommended):

   uv sync
   

3. Install to Claude Desktop: Install the server as a Claude Desktop application:

   uv run mcp install main.py --name "Crypto Stocks"
   

   Configuration file reference:

   {
     "mcpServers": {
       "Crypto Stocks": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/crypto-stocks-mcp",
           "run",
           "main.py"
         ]
       }
     }
   }
   

   Replace /path/to/crypto-stocks-mcp with the actual installation path.

Example Interactions

Using an MCP-compatible client (e.g., Claude Desktop or MCP Inspector):

• List all stocks: Prompt: Show me all crypto-related stocks. Example 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? Example result:

  +----------+-----------------------+---------+----------------------------+
  | Ticker   | Name                  | Price   | Timestamp                  |
  +==========+=======================+=========+============================+
  | COIN     | Coinbase Global Inc.  | 200.50  | 2025-08-07T17:15:00.123456 |
  +----------+-----------------------+---------+----------------------------+
  

• Get historical data: Prompt: Show me the historical prices for MicroStrategy over the past 30 days. Example result:

  +------------+---------+----------+
  | Date       | Close   | Volume   |
  +============+=========+==========+
  | 2025-07-08 | 195.20  | 1200000  |
  | 2025-07-09 | 198.50  | 1300000  |
  | ...        | ...     | ...      |
  +------------+---------+----------+
  

• Use query prompts: Call the stock_query prompt and pass in COIN: Get the latest price and historical data for Coinbase Global Inc. (COIN).

Use Cases

Suitable for scenarios where AI agents need to obtain real-time quotes and historical data for cryptocurrency-related stocks and perform investment analysis, such as integration in MCP-compatible clients like Claude Desktop.

Limitations

• The project is released under the MIT License; see the LICENSE file for details.
• Other feature details, data sources, pricing information, etc. are not yet provided.