Stock Analysis

You can run a Stock Analysis MCP Server that integrates Claude Desktop with powerful stock analysis tools. It supports stock data queries, company fundamentals, and multiple asynchronous market scans, delivering detailed trading plans and real-time task status to help you make informed decisions.

How to use

You will interact with the Stock Analysis MCP Server through Claude Desktop or any MCP client. Start long-running market analyses using asynchronous tasks and monitor progress with task IDs. Use the stock analysis tools to evaluate specific stocks, fetch fundamentals, and run market-wide scans for bullish signals, strong momentum, or hot stocks. When a scan starts, you receive a task ID you can check later with the status endpoint to retrieve results.

How to install

Prerequisites before you begin are:
- Node.js >= 16.0.0
- npm >= 7.0.0
- Claude Desktop

Step-by-step installation and setup:
1. Clone the stock MCP repository
2. Install dependencies
3. Run the development server to test locally
4. Build the project for production
5. Start the MCP server and configure Claude Desktop to connect to it.

How to install

# Step 1: Clone the repository
git clone https://github.com/yourusername/claude-stock-mcp.git
cd claude-stock-mcp

# Step 2: Install dependencies
npm install

# Step 3: Test the server in development mode
npm run dev

# Optional: test with MCP Inspector
npm run inspect

# Step 4: Build the project for production
npm run build

# Step 5: Start the server
npm start

Configure Claude Desktop

Create or edit the Claude Desktop configuration file to register the Stock Analysis MCP Server. Add the following server configuration to connect via MCP runtime using npx.

{
  "mcpServers": {
    "stock_analysis": {
      "command": "npx",
      "args": [
        "@gabriel3615/claude-stock-analysis-mcp@latest"
      ],
      "env": {
        "FMP_API_KEY": "KEY_HERE",
        "APLPVANTAGE_API_KEY": "KEY_HERE"
      }
    }
  }
}

Available tools

get-stock-analysis

Analyze specific stocks to retrieve performance, indicators, and suggested entry/exit points.

company-fundamental

Query company fundamental data using FMP API to fetch revenue, earnings, and other key metrics.

start-bull-bear-scan

Launch an asynchronous market scan to identify bullish and bearish signals across the market.

start-strong-signal-scan

Start an asynchronous scan that highlights stocks with strong momentum signals.

start-hot-stock-scan

Initiate an asynchronous scan to find top trending stocks based on recent activity.

get-task-status

Query the status and results of any running or completed asynchronous tasks.

market-performance

Retrieve today’s market performance including biggest gainers, losers, and highest volume stocks.