How to integrate Alpha vantage MCP with Claude Code

Manage your Alpha vantage directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns. You can do this in two different ways: Via Composio Connect - Direct and easiest approach Via Composio SDK - Programmatic approach with more control

Alpha vantage logoAlpha vantage
Api Key

Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.

56 Tools

Introduction

Manage your Alpha vantage directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns.

You can do this in two different ways:

  1. Via Composio Connect - Direct and easiest approach
  2. Via Composio SDK - Programmatic approach with more control

Also integrate Alpha vantage with

Why use Composio?

  • Only one MCP URL to connect multiple apps with Claude Code with zero auth hassles.
  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

Connecting Alpha vantage to Claude Code using Composio

1. Add the Composio MCP to Claude

Terminal

2. Start Claude Code

bash
claude

3. Open your MCP list

bash
/mcp

4. Select Composio and click on Authenticate

Select Composio and click Authenticate

5. This will redirect you to the Composio OAuth page. Complete the flow by authorizing Composio and you're all set.

Composio OAuth authorization page
Composio authorization complete
Ask Claude to connect to your account and authenticate via the link

What is the Alpha vantage MCP server, and what's possible with it?

The Alpha Vantage MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Alpha Vantage account. It provides structured and secure access to real-time and historical financial data, so your agent can fetch market prices, analyze commodities, review company financials, and retrieve earnings transcripts on your behalf.

  • Get global commodities and market prices: Instantly retrieve real-time and historical price indices for all major commodities and markets—including aluminum, copper, coffee, corn, and crude oil.
  • Analyze company financial statements: Ask your agent to fetch detailed annual or quarterly balance sheets for any supported company, making fiscal analysis a breeze.
  • Access upcoming earnings calendars: Pull comprehensive earnings schedules for the next three months, so you never miss an important financial event.
  • Retrieve earnings call transcripts with sentiment: Automatically obtain full-text earnings call transcripts for a given company and quarter, including sentiment signals to help you gauge market tone.
  • Perform historical data research: Let your agent gather time series data for commodities and financial indicators, supporting deeper market research and trend analysis.

Connecting Alpha vantage via Composio SDK

Composio SDK is the underlying tech that powers Rube. It's a universal gateway that does everything Rube does but with much more programmatic control. You can programmatically generate an MCP URL with the app you need (here Alpha vantage) for even more tool search precision. It's secure and reliable.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Claude Pro, Max, or API billing enabled Anthropic account
  • Composio API Key
  • A Alpha vantage account
  • Basic knowledge of Python or TypeScript
2

Install Claude Code

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

To install Claude Code, use one of the following methods based on your operating system:

3

Set up Claude Code

bash
cd your-project-folder
claude

Open a terminal, go to your project folder, and start Claude Code:

  • Claude Code will open in your terminal
  • Follow the prompts to sign in with your Anthropic account
  • Complete the authentication flow
  • Once authenticated, you can start using Claude Code
Claude Code initial setup showing sign-in prompt
Claude Code terminal after successful login
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here

Create a .env file in your project root with the following variables:

  • COMPOSIO_API_KEY authenticates with Composio (get it from Composio dashboard)
  • USER_ID identifies the user for session management (use any unique identifier)
5

Install Composio library

npm install @composio/core dotenv

Install the Composio TypeScript library to create MCP sessions.

  • @composio/core provides the core Composio functionality
  • dotenv loads environment variables from your .env file
6

Generate Composio MCP URL

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['alpha_vantage'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http alpha_vantage-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Create a script to generate a Composio MCP URL for Alpha vantage. This URL will be used to connect Claude Code to Alpha vantage.

What's happening

  • We import the Composio client and load environment variables
  • Create a Composio instance with your API key
  • Call create() to create a Tool Router session for Alpha vantage
  • The returned mcp.url is the MCP server URL that Claude Code will use
  • The script prints this URL so you can copy it
7

Run the script and copy the MCP URL

node --loader ts-node/esm generate_mcp_url.ts
# or if using tsx
tsx generate_mcp_url.ts

Run your TypeScript script to generate the MCP URL.

  • The script connects to Composio and creates a Tool Router session
  • It prints the MCP URL and the exact command you need to run
  • Copy the entire claude mcp add command from the output
8

Add Alpha vantage MCP to Claude Code

bash
claude mcp add --transport http alpha_vantage-composio "YOUR_MCP_URL_HERE" --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"

# Then restart Claude Code
exit
claude

In your terminal, add the MCP server using the command from the previous step. The command format is:

  • claude mcp add registers a new MCP server with Claude Code
  • --transport http specifies that this is an HTTP-based MCP server
  • The server name (alpha_vantage-composio) is how you'll reference it
  • The URL points to your Composio Tool Router session
  • --headers includes your Composio API key for authentication

After running the command, close the current Claude Code session and start a new one for the changes to take effect.

9

Verify the installation

bash
claude mcp list

Check that your Alpha vantage MCP server is properly configured.

  • This command lists all MCP servers registered with Claude Code
  • You should see your alpha_vantage-composio entry in the list
  • This confirms that Claude Code can now access Alpha vantage tools

If everything is wired up, you should see your alpha_vantage-composio entry listed:

Claude Code MCP list showing the toolkit MCP server
10

Authenticate Alpha vantage

The first time you try to use Alpha vantage tools, you'll be prompted to authenticate.

  • Claude Code will detect that you need to authenticate with Alpha vantage
  • It will show you an authentication link
  • Open the link in your browser (or copy/paste it)
  • Complete the Alpha vantage authorization flow
  • Return to the terminal and start using Alpha vantage through Claude Code

Once authenticated, you can ask Claude Code to perform Alpha vantage operations in natural language. For example:

  • "Get latest Brent crude oil prices"
  • "Show upcoming earnings calendar for tech stocks"
  • "Fetch annual balance sheet for Apple"

Complete Code

Here's the complete code to get you started with Alpha vantage and Claude Code:

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['alpha_vantage'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http alpha_vantage-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Conclusion

You've successfully integrated Alpha vantage with Claude Code using Composio's MCP server. Now you can interact with Alpha vantage directly from your terminal using natural language commands.

Key features of this setup:

  • Terminal-native experience without switching contexts
  • Natural language commands for Alpha vantage operations
  • Secure authentication through Composio's managed MCP
  • Tool Router for dynamic tool discovery and execution

Next steps:

  • Try asking Claude Code to perform various Alpha vantage operations
  • Add more toolkits to your Tool Router session for multi-app workflows
  • Integrate this setup into your development workflow for increased productivity

You can extend this by adding more toolkits, implementing custom workflows, or building automation scripts that leverage Claude Code's capabilities.

TOOLS

Supported Tools

Every Alpha vantage action and event your agent gets out of the box.

Get All Commodities Price Index

Tool to retrieve the global price index of all commodities.

ALUMINUM

Tool to fetch global aluminum prices.

Balance Sheet

Tool to return annual and quarterly balance sheets for a company.

Brent Crude Oil Prices

Tool to fetch Brent crude oil prices.

Cash Flow

Tool to return annual and quarterly cash flow statements for a company.

Global Coffee Price

Tool to retrieve the global coffee price series.

Company Overview (Stocks Only)

Tool to retrieve company overview and fundamental data for individual company stocks.

COPPER

Tool to fetch global price of copper in monthly, quarterly, and annual intervals.

Corn

Tool to retrieve global price of corn in monthly, quarterly, and annual intervals.

COTTON

Tool to retrieve global cotton prices in monthly, quarterly, and annual intervals.

Consumer Price Index (CPI)

Tool to fetch monthly and semiannual Consumer Price Index (CPI) data of the United States.

Crypto Intraday Time Series

Tool to retrieve intraday time series data for cryptocurrencies with realtime updates.

Currency Exchange Rate

Tool to retrieve real-time exchange rate for a currency pair.

Digital Currency Daily Time Series

Tool to retrieve daily historical time series for a digital currency traded on a specific market.

Digital Currency Monthly Time Series

Tool to retrieve monthly digital currency prices in a fiat currency.

Digital Currency Weekly Time Series

Tool to retrieve weekly digital currency prices in a fiat currency.

Durable Goods Orders

Tool to fetch monthly manufacturers' new orders of durable goods data for the United States.

Earnings

Tool to retrieve annual and quarterly earnings (EPS history) for a specific company symbol.

Earnings Calendar

Tool to return the earnings calendar for the next three months.

Earnings Call Transcript

Tool to retrieve the earnings call transcript for a given company and quarter.

Federal Funds Rate

Tool to fetch daily, weekly, and monthly federal funds rate data of the United States.

FX Daily Time Series

Tool to fetch daily time series (open, high, low, close) for a currency pair.

FX Intraday Time Series

Tool to retrieve intraday OHLC time series for a forex pair at 1-60 minute intervals (premium endpoint).

FX Monthly Time Series

Tool to get monthly time series (open, high, low, close) for a currency pair.

FX Weekly Time Series

Tool to get weekly time series (open, high, low, close) for a currency pair.

Get Dividend History

Tool to retrieve historical dividend payment records for a stock symbol.

Get Historical Options

Tool to retrieve full historical options chain for a symbol on a specific date with 15+ years of history, including Greeks and IV.

Analytics Sliding Window

Tool to retrieve advanced analytics metrics with sliding window calculations for trend analysis.

Global Quote

Tool to retrieve latest price and volume information for a specified security ticker in realtime.

Income Statement

Tool to fetch annual and quarterly income statements.

Inflation

Tool to fetch annual U.

IPO Calendar

Tool to retrieve the IPO calendar for the next three months.

Listing Status

Tool to fetch listing status of US stocks and ETFs.

Market Status

Tool to retrieve current market status (open/closed) for global stock exchanges.

News Sentiment

Tool to fetch live and historical market news & sentiment.

Nonfarm Payroll

Tool to fetch monthly U.

Real GDP

Tool to fetch U.

Real GDP Per Capita

Tool to fetch quarterly Real GDP per capita data of the United States.

Realtime Bulk Quotes

Tool to retrieve realtime quotes for US-traded symbols in bulk (up to 100 symbols per request).

Retail Sales

Tool to fetch monthly retail trade sales data of the United States.

Sector Performance

Tool to retrieve real-time and historical sector performance data.

Stock Splits

Tool to retrieve historical stock split events for a symbol.

Global Sugar Price

Tool to retrieve the global sugar price series.

Symbol Search

Tool to search for best-matching symbols based on keywords.

Technical Indicator

Tool to fetch technical indicators for the specified equity or currency pair.

Time Series Daily

Tool to retrieve daily time series data (date, daily open, high, low, close, volume) for a global equity symbol, covering 20+ years of historical data.

Time Series Intraday

Tool to retrieve intraday OHLCV for a given equity.

Time Series Intraday Extended

Tool to retrieve historical intraday OHLCV data for the trailing 2 years, covering over 2 million data points per ticker.

Time Series Monthly

Tool to retrieve monthly open, high, low, close, and volume for a global equity.

Monthly Adjusted Time Series

Tool to retrieve monthly adjusted OHLC and volume for a global equity.

Weekly Time Series

Tool to fetch weekly open, high, low, close, and volume for a global equity symbol.

Weekly Adjusted Time Series

Tool to fetch weekly adjusted time series data with split/dividend adjustments, covering 20+ years of historical data.

Top Gainers, Losers & Most Active

Tool to fetch the top 20 gainers, losers, and most actively traded US tickers.

US Treasury Yield

Tool to fetch US Treasury yield data for specified maturity and interval.

Unemployment Rate

Tool to fetch monthly unemployment rate data of the United States.

WHEAT

Tool to fetch global price of wheat.

FAQ

Frequently asked questions

With a standalone Alpha vantage MCP server, the agents and LLMs can only access a fixed set of Alpha vantage tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Alpha vantage and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Alpha vantage tools.

Yes, absolutely. You can configure which Alpha vantage scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Alpha vantage data and credentials are handled as safely as possible.

Start with Alpha vantage.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Alpha vantage tool your agent needs.Free to start.

Start building