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 Examples

Basic Usage

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