Stock Market

MCP server to connect to the Alpha Vantage APIs

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ctoouli-mcp-stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can use this MCP Stock Market server to retrieve daily stock data from Alpha Vantage via a simple MCP interface. It lets you request data for any stock symbol and integrates directly with your MCP client to fetch up-to-date pricing information for analysis, dashboards, or alerts.

How to use

To use this server with your MCP client, configure a local, stdio-based MCP connection that launches the server process. You interact with the server via the get-stock-data tool to request daily stock information for a specific symbol (for example AAPL or IBM). The tool returns the latest available daily prices, including open, high, low, close, and volume, along with a timestamp and time zone.

How to install

Prerequisites you need before running this server:

Node.js v18 or higher

An Alpha Vantage API key (free tier available)

Install dependencies

npm install

Create a configuration file with your Alpha Vantage API key in a .env file

ALPHA_VANTAGE_API_KEY=your_api_key_here

Build the project

npm run build

Additional steps and notes

Prepare the MCP client configuration to run the stock market server locally. This example shows how to launch the server using Node.js and the built index.js file.

{
  "mcpServers": {
    "stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ]
    }
  }
}

Troubleshooting

If you run into issues, follow these checks to resolve common problems quickly.

Ensure your Alpha Vantage API key is correctly set in the .env file

Verify you are using Node.js version 18 or higher

Confirm the MCP client configuration path is correct and points to the built index.js

Restart your MCP client after making changes

Available tools

get-stock-data

Retrieves daily stock market data for a specific stock symbol. Returns open, high, low, close, and volume for each date in the requested period.