Alphavantage

liveFinanceMarkets

Stock market data, fundamentals, and earnings. Requires your own PAID Alpha Vantage API key (_apiKey); a free-tier key will not work here. Keyless alternative for US company financials: sec-xbrl.

6tools
0msauth
free tier50 calls/day
🔑Authentication

BYO only, and the key must be PAID (Bruce, fleet #1117). Alpha Vantage meters its free tier by source IP and never validates the key, so a free key — yours or Pipeworx's — is refused when the call is made through the gateway. Premium is the one thing it authenticates. Pass it as _apiKey. With no paid key, use sec-xbrl (keyless US financial statements) or finnhub (quotes) instead.

Config with credentials

Get an API key →

Tools

av_quote

Get real-time stock price for a symbol (e.g., "AAPL"). Returns current price, change, percent change, and trading volume. Needs your own PAID Alpha Vantage key via _apiKey — Pipeworx fronts no key for

No parameters required.

▶Try it
av_daily

Get daily stock price history for a symbol (e.g., "AAPL"). Returns open, high, low, close, volume for recent days or full 20+ year history. Needs your own PAID Alpha Vantage key via _apiKey — Pipeworx

No parameters required.

▶Try it
av_overview

Get company fundamentals for a symbol (e.g., "AAPL"). Returns sector, market cap, P/E ratio, EPS, dividend yield, 52-week range, and analyst ratings. Needs your own PAID Alpha Vantage key via _apiKey

No parameters required.

▶Try it
av_income_statement

Get annual and quarterly income statements for a symbol (e.g., "AAPL"). Returns revenue, gross profit, operating income, net income, and EBITDA. Needs your own PAID Alpha Vantage key via _apiKey — Pip

No parameters required.

▶Try it
av_balance_sheet

Get annual and quarterly balance sheets for a symbol (e.g., "AAPL"). Returns total assets, liabilities, equity, cash, and debt. Needs your own PAID Alpha Vantage key via _apiKey — Pipeworx fronts no k

No parameters required.

▶Try it
av_earnings

Get quarterly earnings data for a symbol (e.g., "AAPL"). Returns reported and estimated EPS, surprise amount, and surprise percentage. Needs your own PAID Alpha Vantage key via _apiKey — Pipeworx fron

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/alphavantage/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/alphavantage/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"av_quote","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("av_quote", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("stock market data, fundamentals, and earnings");

Related compound tools

These combine Alphavantage with other data sources in a single call:

Fintech Intel

FinTech Intel — meta-pack chaining SEC EDGAR, CFPB, FDIC, and Alpha Vantage for company deep-dives, bank health checks, and market snapshots.

3 tools — fintech_company_deep_dive, fintech_bank_health_check, fintech_market_snapshot