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
| Name | Type | Required | Description |
|---|---|---|---|
_apiKey | string | yes | REQUIRED — your own PAID Alpha Vantage key. Pipeworx does not front a key for this pack. |
symbol | string | yes | Stock 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
| Field | Type | Description |
|---|---|---|
symbol | string | |
count | number | |
estimates | array | |
source | string | |
retrieved_at | string |
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.