`av_overview`

Pack: alphavantage · Endpoint: https://gateway.pipeworx.io/alphavantage/mcp

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.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Alpha Vantage API key
`symbol`	string	yes	Stock ticker symbol (e.g., “AAPL”, “GOOGL”)

Example call

Arguments

{
  "_apiKey": "your-alphavantage-api-key",
  "symbol": "AAPL"
}

curl

curl -X POST https://gateway.pipeworx.io/alphavantage/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"av_overview","arguments":{"_apiKey":"your-alphavantage-api-key","symbol":"AAPL"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('av_overview', {
  "_apiKey": "your-alphavantage-api-key",
  "symbol": "AAPL"
});

More examples

{
  "_apiKey": "your-alphavantage-api-key",
  "symbol": "GOOGL"
}

Response shape

Always returns: symbol

Field	Type	Description
`symbol`	string	Stock ticker symbol
`name`	string \| null	Company name
`description`	string \| null	Company description
`exchange`	string \| null	Stock exchange listing
`currency`	string \| null	Currency code
`country`	string \| null	Company country
`sector`	string \| null	Industry sector
`industry`	string \| null	Industry classification
`market_cap`	string \| null	Market capitalization
`pe_ratio`	string \| null	Price-to-earnings ratio
`peg_ratio`	string \| null	Price/earnings to growth ratio
`book_value`	string \| null	Book value per share
`dividend_per_share`	string \| null	Dividend per share
`dividend_yield`	string \| null	Dividend yield percentage
`eps`	string \| null	Earnings per share
`revenue_per_share`	string \| null	Revenue per share (TTM)
`profit_margin`	string \| null	Profit margin percentage
`operating_margin`	string \| null	Operating margin (TTM)
`return_on_assets`	string \| null	Return on assets (TTM)
`return_on_equity`	string \| null	Return on equity (TTM)
`revenue_ttm`	string \| null	Revenue trailing twelve months
`gross_profit_ttm`	string \| null	Gross profit (TTM)
`ebitda`	string \| null	EBITDA
`beta`	string \| null	Beta coefficient
`week_52_high`	string \| null	52-week high price
`week_52_low`	string \| null	52-week low price
`moving_average_50`	string \| null	50-day moving average
`moving_average_200`	string \| null	200-day moving average
`shares_outstanding`	string \| null	Shares outstanding
`fiscal_year_end`	string \| null	Fiscal year end month
`latest_quarter`	string \| null	Latest quarter date

Full JSON Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Stock ticker symbol"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Company name"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Company description"
    },
    "exchange": {
      "type": [
        "string",
        "null"
      ],
      "description": "Stock exchange listing"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "Currency code"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Company country"
    },
    "sector": {
      "type": [
        "string",
        "null"
      ],
      "description": "Industry sector"
    },
    "industry": {
      "type": [
        "string",
        "null"
      ],
      "description": "Industry classification"
    },
    "market_cap": {
      "type": [
        "string",
        "null"
      ],
      "description": "Market capitalization"
    },
    "pe_ratio": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price-to-earnings ratio"
    },
    "peg_ratio": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price/earnings to growth ratio"
    },
    "book_value": {
      "type": [
        "string",
        "null"
      ],
      "description": "Book value per share"
    },
    "dividend_per_share": {
      "type": [
        "string",
        "null"
      ],
      "description": "Dividend per share"
    },
    "dividend_yield": {
      "type": [
        "string",
        "null"
      ],
      "description": "Dividend yield percentage"
    },
    "eps": {
      "type": [
        "string",
        "null"
      ],
      "description": "Earnings per share"
    },
    "revenue_per_share": {
      "type": [
        "string",
        "null"
      ],
      "description": "Revenue per share (TTM)"
    },
    "profit_margin": {
      "type": [
        "string",
        "null"
      ],
      "description": "Profit margin percentage"
    },
    "operating_margin": {
      "type": [
        "string",
        "null"
      ],
      "description": "Operating margin (TTM)"
    },
    "return_on_assets": {
      "type": [
        "string",
        "null"
      ],
      "description": "Return on assets (TTM)"
    },
    "return_on_equity": {
      "type": [
        "string",
        "null"
      ],
      "description": "Return on equity (TTM)"
    },
    "revenue_ttm": {
      "type": [
        "string",
        "null"
      ],
      "description": "Revenue trailing twelve months"
    },
    "gross_profit_ttm": {
      "type": [
        "string",
        "null"
      ],
      "description": "Gross profit (TTM)"
    },
    "ebitda": {
      "type": [
        "string",
        "null"
      ],
      "description": "EBITDA"
    },
    "beta": {
      "type": [
        "string",
        "null"
      ],
      "description": "Beta coefficient"
    },
    "week_52_high": {
      "type": [
        "string",
        "null"
      ],
      "description": "52-week high price"
    },
    "week_52_low": {
      "type": [
        "string",
        "null"
      ],
      "description": "52-week low price"
    },
    "moving_average_50": {
      "type": [
        "string",
        "null"
      ],
      "description": "50-day moving average"
    },
    "moving_average_200": {
      "type": [
        "string",
        "null"
      ],
      "description": "200-day moving average"
    },
    "shares_outstanding": {
      "type": [
        "string",
        "null"
      ],
      "description": "Shares outstanding"
    },
    "fiscal_year_end": {
      "type": [
        "string",
        "null"
      ],
      "description": "Fiscal year end month"
    },
    "latest_quarter": {
      "type": [
        "string",
        "null"
      ],
      "description": "Latest quarter date"
    }
  },
  "required": [
    "symbol"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "alphavantage": {
      "url": "https://gateway.pipeworx.io/alphavantage/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

av_overview