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.