Alpha Vantage MCP Server

by matteoantoci

374 downloads

Not rated

GitHub

Other

About

MCP server for interacting with the Alpha Vantage API, providing access to various financial data endpoints.

Details

Author: matteoantoci
Downloads: 374
Categories: Other

- Exposes nine categories of financial data as MCP tools
- Uses stdio transport for integration with MCP runners
- Automatically discoverable tool schemas via introspection
- Covers Core Stocks, Options, Intelligence, and Fundamentals
- Includes Technical Indicators, Forex, Crypto, Commodities, and Economic Indicators

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 Alpha Vantage MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

From the repository

Clone the repository, install dependencies with npm install, and build with npm run build. Configure the ALPHAVANTAGE_API_KEY environment variable via your MCP runner’s settings, then run the server using stdio transport (e.g., npm run start or via an MCP client configuration pointing to the built index.js).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "alpha vantage mcp server": {
            "mcp-alphavantage": {
                "command": "node",
                "args": [
                    "build/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-alphavantage": {
        "command": "node",
        "args": [
            "build/index.js"
        ]
    }
}

Alpha Vantage MCP Server

A Model Context Protocol (MCP) server that exposes various Alpha Vantage API endpoints as MCP tools, providing access to financial data including core stocks, options, intelligence, fundamental data, and technical indicators. This server simplifies integrating Alpha Vantage data into MCP-compatible agents and systems.

Prerequisites

- Node.js (v18 or later recommended)
- npm (comes with Node.js)
- Alpha Vantage API key
- (Optional) MCP-compatible client or runner (e.g., VSCode extension, CLI)

Setup

1. Clone the repository or ensure you are in the project directory.

2. Install dependencies:

   npm install

3. Configuration:
Obtain an Alpha Vantage API key from https://www.alphavantage.co/.
Configure the ALPHAVANTAGE_API_KEY environment variable via your MCP runner's settings. This is the recommended method for seamless integration with the MCP client. Avoid using .env files for this purpose when running via an MCP runner.

Building and Running

1. Build the server:

   npm run build

This will create a build directory with the compiled JavaScript code.

2. Run the server:

   npm run start

or directly:

   node build/index.js

3. Via MCP runner:
Configure your MCP client to run the server using stdio transport.
Example MCP settings entry (adjust /path/to/mcp-alphavantage to your actual path and replace YOUR_API_KEY_HERE with your actual key):

   "alphavantage": {

     "transportType": "stdio",

     "command": "node",

     "args": [

       "/path/to/mcp-alphavantage/build/index.js"

     ],

     "env": {

       "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"

     }

     // ... other optional settings ...

   }

Available Tools

The server exposes Alpha Vantage API endpoints as distinct MCP tools, categorized by function:

- Core Stocks
- Options Data
- Alpha Intelligence
- Fundamental Data
- Technical Indicators
- Forex
- Cryptocurrencies
- Commodities
- Economic Indicators

Detailed input schemas and descriptions for each tool are automatically discoverable by MCP agents connecting to the server via introspection.

Project Structure

The project follows a modular structure:

.
├── src/
│   ├── index.ts          # Server entry point
│   └── tools/
│       ├── index.ts      # Registers all tool categories
│       ├── fundamentals/ # Fundamental Data tools
│       │   └── ...
│       ├── indicators/   # Technical Indicators tools
│       │   └── ...
│       ├── intelligence/ # Alpha Intelligence tools
│       │   └── ...
│       ├── options/      # Options Data tools
│       │   └── ...
│       ├── stocks/       # Core Stocks tools
│       │   └── ...
│       ├── forex/        # Forex tools
│       │   └── ...
│       ├── crypto/       # Cryptocurrency tools
│       │   └── ...
│       ├── commodities/  # Commodities tools
│       │   └── ...
│       └── economic/     # Economic Indicators tools
│           └── ...
├── memory-bank/          # Project documentation
│   └── ...
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── eslint.config.js      # ESLint configuration
├── .prettierrc           # Prettier configuration
├── LICENSE               # Project license
└── README.md             # This file

Licensing

This project is licensed under the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See the LICENSE file for details.

Contributing

Contributions are welcome! Please follow the standard fork-and-pull request workflow.

Support

For issues or questions, please open an issue on the GitHub repository.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Alpha Vantage MCP Server

Prerequisites

Setup

Building and Running

Available Tools

Project Structure

Licensing

Contributing

Support

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀