Stock Market (Alpha Vantage)
About
Provides real-time stock market data through the Alpha Vantage API, delivering daily prices, volume, and metrics for any stock symbol with proper currency formatting and rate-limit awareness.
Details
- Repository
- ctoouli/mcp-stock-market
- License
- Apache-2.0
Explore
- Retrieves daily stock prices (open, high, low, close, volume)
- Supports any valid stock symbol (e.g., AAPL, GOOG)
- Returns time‑zone aware data (US/Eastern)
- Simple MCP tool interface for easy integration
- Runs on Node.js v18 or higher
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Stock Market (Alpha Vantage)Command (node, npx, python, etc.)nodeArguments-
Argument 1
/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js v18 or higher
- An Alpha Vantage API key (free tier available)
To use this tool with your MCP client, you need to update your MCP server configuration. Add the following to your client's configuration:
{
"mcpServers": {
"stock-market": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
]
}
}
}
Make sure to replace /ABSOLUTE/PATH/TO/PARENT/FOLDER with the actual absolute path to the parent directory containing this repository.
get-stock-data
Retrieves daily stock market data for a specific stock symbol. Parameters: symbol (string) - Stock symbol (e.g., IBM, AAPL, MSFT, GOOG, AMZN)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"stock market (alpha vantage)": {
"cwd": null,
"env": {},
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
],
"shell": false,
"command": "node"
}
}
}Linux
{
"cwd": null,
"env": [],
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
],
"shell": false,
"command": "node"
}Macos
{
"cwd": null,
"env": [],
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
],
"shell": false,
"command": "node"
}Windows
{
"cwd": null,
"env": [],
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
],
"shell": false,
"command": "node"
}A Model Context Protocol (MCP) tool for retrieving stock market data using the Alpha Vantage API. This tool provides access to daily stock market data for any stock symbol through a simple MCP interface.
Requirements
- Node.js v18 or higher
- An Alpha Vantage API key (free tier available)
Setup
1. Install dependencies
npm install
2. Create a .env file based on .env.example and add your Alpha Vantage API key
ALPHA_VANTAGE_API_KEY=your_api_key_here
You can obtain a free API key from Alpha Vantage.
3. Build the project
npm run build
MCP Client Configuration
To use this tool with your MCP client, you need to update your MCP server configuration. Add the following to your client's configuration:
{
"mcpServers": {
"stock-market": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
]
}
}
}
Make sure to replace /ABSOLUTE/PATH/TO/PARENT/FOLDER with the actual absolute path to the parent directory containing this repository.
Available Tools
get-stock-data
Retrieves daily stock market data for a specific stock symbol.
Parameters:
- symbol: Stock symbol (e.g., IBM, AAPL, MSFT, GOOG, AMZN)
Example usage in an MCP client:
@stock-market get-stock-data symbol=AAPL
Example response:
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
