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