Alphavantage

live FinanceMarkets

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.

6 tools
0ms auth
free tier 50 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 a real-time stock quote including price, change, change percent, volume, and latest trading day.

No parameters required.

▶ Try it
av_daily

Get daily time series (open, high, low, close, volume) for a stock. Returns up to 100 recent trading days by default, or 20+ years of full history.

No parameters required.

▶ Try it
av_overview

Get company overview and fundamentals including description, sector, market cap, P/E ratio, EPS, dividend yield, 52-week range, and more.

No parameters required.

▶ Try it
av_income_statement

Get income statement data for a company, including both annual and quarterly reports. Shows revenue, gross profit, operating income, net income, EBITDA, and more.

No parameters required.

▶ Try it
av_balance_sheet

Get balance sheet data for a company, including both annual and quarterly reports. Shows total assets, liabilities, equity, cash, debt, and more.

No parameters required.

▶ Try it
av_earnings

Get earnings data for a company, including annual and quarterly EPS (reported and estimated), surprise amount, and surprise percentage.

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