stock-market

This Stock Market MCP Server provides tools to fetch real-time market data and company financial information via the Alpha Vantage API. The server exposes endpoints/tools such as get_ticker_price for real-time stock prices, get_market_report for a high-level US market overview, get_financial_statement for income/balance/cashflow statements, and get_company_overview for key company details. To use, start the server with the required Alpha Vantage API key configured in the environment, then invoke the available tools through your MCP client or integration, providing the necessary stock tickers and parameters. The server handles API calls to Alpha Vantage and returns JSON formatted results suitable for downstream processing or chatbot responses.

Prerequisites:

• Node.js and npm installed on your system
• An Alpha Vantage API key

Install and run locally:

1. Clone or download the repository.
2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Run in development or production mode. Ensure you provide your Alpha Vantage API key via environment variable ALPHAVANTAGE_API_KEY. Example run:

export ALPHAVANTAGE_API_KEY=YOUR_API_KEY
node build/index.js

Optional (watch mode for automatic rebuild during development):

npm run watch

Notes and tips:

• You must supply a valid Alpha Vantage API key before starting the server. Set the environment variable ALPHAVANTAGE_API_KEY accordingly.
• The Alpha Vantage API has rate limits; plan requests to avoid hitting the limit and consider caching results where appropriate.
• The server exposes the following tools: get_ticker_price (ticker), get_market_report, get_financial_statement (ticker, type: income|balance|cashflow), get_company_overview (ticker).
• Responses are returned in JSON format for easy integration with MCP clients or chatbots.
• If you encounter issues with tooling or build, ensure dependencies are installed and the build step completed successfully (npm run build).