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.