The MCP Avantage server provides a wrapper for the Alpha Vantage API, enabling LLMs to access comprehensive financial and economic data:
- Core Stock Data: Intraday, daily, weekly, monthly time series, realtime quotes, and symbol search
- Fundamental Data: Company overviews, financial statements (income, balance sheet, cash flow), earnings, dividends, and splits
- Market Intelligence: News, sentiment, top gainers/losers, and insider transactions
- Forex & Cryptocurrency: Realtime exchange rates and time series data
- Commodities: Prices for crude oil, natural gas, metals, agricultural products, and global indices
- Economic Indicators: GDP, inflation, CPI, unemployment, treasury yields, and federal funds rates
- Technical Indicators: SMA, EMA, MACD, RSI, Bollinger Bands, and more
- Premium Features: Options chain data (with premium API key)
- Implementation Features: Multi-user API key management, TypeScript integration, and standard MCP interface compatibility
Provides configuration management through environment variables, allowing the server to securely store API keys and settings like premium access status, log levels, and resource cleanup intervals.
Enables version control and project setup through cloning the repository as part of the installation process.
Provides the runtime environment for the server, with v20 or later required for proper operation of the Alpha Vantage API wrapper.
Offers package management for installing and updating the server's dependencies, including the core @missionsquad/avantage library.
Leverages strong typing for Alpha Vantage API interactions, ensuring type safety when accessing financial data endpoints and handling responses.
Provides package management capabilities as an alternative to npm for installing and managing the server's dependencies.
Uses schema validation for tool parameters, ensuring that requests to the Alpha Vantage API are properly formatted with valid input values.
MCP Server for Alpha Vantage API (@missionsquad/avantage)
This project provides a Model Context Protocol (MCP) server that wraps the @missionsquad/avantage
library, exposing Alpha Vantage API functionalities as tools for Language Learning Models (LLMs).
Overview
This server allows LLMs to interact with the Alpha Vantage API to retrieve financial data, including:
- Core Stock Data (Time Series, Quotes, Search)
- Fundamental Data (Company Overview, Financials, Calendars)
- Forex (FX) Data
- Cryptocurrency Data
- Commodities Data
- Economic Indicators
- Technical Indicators
- Alpha Intelligence (News, Sentiments, etc.)
- Options Data (Premium)
It leverages the @missionsquad/avantage
TypeScript library and follows the architecture of the generic MCP server template, including multi-user API key handling and resource management for AVantage
client instances.
Key Features:
- Comprehensive Coverage: Implements MCP tools for nearly all functions available in the
@missionsquad/avantage
library. - Multi-User Support: Handles Alpha Vantage API keys securely via
extraArgs
(preferred) or fallback to environment variables. - Resource Management: Efficiently manages
AVantage
client instances using theResourceManager
. - Strongly Typed: Built with TypeScript, leveraging types from
@missionsquad/avantage
and Zod schemas for tool parameters. - Standard MCP Interface: Uses
@missionsquad/fastmcp
for MCP communication.
Getting Started
Prerequisites
- Node.js v20 or later
- npm or yarn
- An Alpha Vantage API Key (Get one here)
Setup
- Clone or Copy: Clone this repository or copy the files.
- Install Dependencies:
- Configure Environment:
- Copy
.env.example
to.env
. - Edit
.env
and setAPI_KEY
to your Alpha Vantage API key. - Optionally set
AV_PREMIUM=true
if you have a premium subscription. - Adjust
LOG_LEVEL
orRESOURCE_CLEANUP_INTERVAL
if needed.
- Copy
- Build the Project:
- Start the Server:The server will listen for MCP requests on stdio.
Authentication
The server uses the standard multi-user token handling pattern:
extraArgs.apiKey
(Recommended): Pass the user-specific Alpha Vantage API key in theapiKey
field of theextraArgs
object during the MCPcall_tool
request. This key is not part of the tool's schema..env
Fallback: IfextraArgs.apiKey
is not provided, the server uses theAPI_KEY
value from the.env
file.
Available Tools
This server exposes numerous tools corresponding to the methods in the @missionsquad/avantage
library. Tools are generally named module_method
(e.g., coreStock_intraday
, fundamentalData_companyOverview
).
Refer to the Alpha Vantage documentation and the @missionsquad/avantage
library's types (src/types/*
within the library) for details on parameters and return structures.
Example Tool Call (Conceptual MCP Request):
Tool Categories (Modules):
alphaIntelligence_*
commodities_*
coreStock_*
crypto_*
economicIndicators_*
forex_*
fundamentalData_*
optionsData_*
(Premium)technicalIndicators_*
Use the MCP list_tools
command to get the full list of available tools, their descriptions, and parameter schemas.
Configuration
Configure via .env
file:
Variable | Description | Default |
---|---|---|
API_KEY | Fallback Alpha Vantage API key if not in extraArgs | null |
LOG_LEVEL | Logging level (error , warn , info , debug ) | info |
RESOURCE_CLEANUP_INTERVAL | Interval (ms) to clean up inactive AVantage client instances | 1800000 (30m) |
AV_PREMIUM | Set to true to enable premium endpoint access in avantage | false |
Project Structure
Follows the generic MCP server template structure. Key files:
src/index.ts
: Main server entry point, tool definitions.src/config.ts
: Configuration loading.src/logger.ts
: Logging utility.src/resource-manager.ts
: ManagesAVantage
instances.src/schemas.ts
: Zod schemas for tool parameters..nexus/
: Nexus documentation.
Nexus Documentation
.nexus/features/avantage_integration/feature.md
.nexus/architecture/server_structure.md
.nexus/guides/using_avantage_tools.md
.nexus/decisions/decision_log.md
License
MIT (Assuming the template license is MIT. Verify.)
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that enables LLMs to access comprehensive financial data from Alpha Vantage API, including stock prices, fundamentals, forex, crypto, and economic indicators.
Related MCP Servers
- AsecurityFlicenseAqualityThis is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.Last updated -2156JavaScript
- -securityAlicense-qualityA Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.Last updated -4PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to analyze options chains, calculate Greeks, and evaluate basic options strategies through Yahoo Finance data.Last updated -4PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.Last updated -PythonMIT License
Appeared in Searches
- A server for finding scientific articles, creating ad ideas, and deploying Facebook ads
- A platform for live probability option trading with indicators across multiple markets
- A server for obtaining historical cryptocurrency market data
- A tool or service for checking cryptocurrency prices
- A tool for analyzing Indian stock data for investment decisions using LLMs and news insights