kukapay/crypto-stocks-mcp

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 (recommended) or pip for dependency management

Setup

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 as a reference:

   {
      "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 file for details.