av_earnings_estimates

Pack: alphavantage · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/av_earnings_estimates for the schema, then POST the same URL with its arguments for the data.

Get analyst consensus estimates for a symbol (e.g., “AAPL”): per forward fiscal quarter and fiscal year, mean/high/low EPS and revenue estimate, analyst counts, and how the mean EPS estimate has moved over 7, 30, 60 and 90 days. Use for “what does the Street expect AAPL to earn and sell next quarter”. Forward estimates only; for reported-versus-estimate history use av_earnings. Needs your own PAID Alpha Vantage key via _apiKey — Pipeworx fronts a key for paid accounts only.

Parameters

NameTypeRequiredDescription
_apiKeystringyesREQUIRED — your own PAID Alpha Vantage key. Pipeworx does not front a key for this pack.
symbolstringyesStock ticker symbol (e.g., “AAPL”, “IBM”)

Example call

Arguments

{
  "symbol": "IBM"
}

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_earnings_estimates","arguments":{"symbol":"IBM"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('av_earnings_estimates', {
  "symbol": "IBM"
});

Response shape

Always returns: symbol, estimates

FieldTypeDescription
symbolstring
countnumber
estimatesarray
sourcestring
retrieved_atstring
Full JSON Schema
{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "estimates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "period_end": {
            "type": [
              "string",
              "null"
            ]
          },
          "horizon": {
            "type": [
              "string",
              "null"
            ]
          },
          "eps_mean": {
            "type": [
              "number",
              "null"
            ]
          },
          "eps_high": {
            "type": [
              "number",
              "null"
            ]
          },
          "eps_low": {
            "type": [
              "number",
              "null"
            ]
          },
          "eps_analyst_count": {
            "type": [
              "number",
              "null"
            ]
          },
          "revenue_mean": {
            "type": [
              "number",
              "null"
            ]
          },
          "revenue_high": {
            "type": [
              "number",
              "null"
            ]
          },
          "revenue_low": {
            "type": [
              "number",
              "null"
            ]
          },
          "revenue_analyst_count": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "id"
        ]
      }
    },
    "source": {
      "type": "string"
    },
    "retrieved_at": {
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "estimates"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the alphavantage pack
{
  "mcpServers": {
    "alphavantage": {
      "url": "https://gateway.pipeworx.io/alphavantage/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 17, 2026