MCP Server for Alpha Vantage API (@missionsquad/avantage)

What is MCP Server for Alpha Vantage API (@missionsquad/avantage)?

This MCP server wraps the @missionsquad/avantage library to expose Alpha Vantage API financial data as tools for Language Learning Models (LLMs). It provides core stock data, fundamental data, forex, cryptocurrencies, commodities, economic indicators, technical indicators, alpha intelligence, and options data. The server is built with TypeScript and uses @missionsquad/fastmcp for MCP communication.

How to use MCP Server for Alpha Vantage API (@missionsquad/avantage)?

Prerequisites: Node.js v20+, npm/yarn, and an Alpha Vantage API key. Clone the repository, run npm install (or yarn install), copy .env.example to .env and set API_KEY. Optionally set AV_PREMIUM=true for premium endpoints. Build with npm run build and start with npm start. The server listens on stdio. Authentication: pass apiKey in extraArgs during MCP call_tool requests, or rely on the API_KEY environment variable as fallback.

Key features of MCP Server for Alpha Vantage API (@missionsquad/avantage)

• Comprehensive tool coverage across Alpha Vantage modules
• Multi-user API key handling via extraArgs or environment
• Resource management for efficient AVantage client instances
• Strongly typed with TypeScript and Zod schemas
• Standard MCP interface using @missionsquad/fastmcp

Use cases of MCP Server for Alpha Vantage API (@missionsquad/avantage)

• Retrieve real-time and historical stock quotes for analysis
• Get company overviews, income statements, and balance sheets
• Perform technical indicator calculations (e.g., SMA, RSI)
• Access forex and cryptocurrency exchange rates
• Fetch economic indicators and news sentiment data

FAQ from MCP Server for Alpha Vantage API (@missionsquad/avantage)

How does authentication work?

You can pass a user-specific Alpha Vantage API key in the apiKey field of extraArgs during call_tool requests. If not provided, the server uses the API_KEY value from the .env file as fallback.

What are the prerequisites?

Node.js version 20 or later, npm or yarn, and a valid Alpha Vantage API key (free or premium) from alphavantage.co.

How do I enable premium endpoints?

Set AV_PREMIUM=true in the .env file to grant the underlying library access to premium Alpha Vantage endpoints.

How can I see all available tools?

Use the MCP list_tools command to get the full list of tools, their descriptions, and parameter schemas.

What configuration options exist?

Configure via .env variables: API_KEY (fallback key), LOG_LEVEL (error/warn/info/debug), RESOURCE_CLEANUP_INTERVAL (ms, default 30 minutes), and AV_PREMIUM (boolean).