analyst_price_targets
Pack: analyst-ratings · 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/analyst_price_targets for the schema, then POST the same URL with its arguments for the data.
Analyst price-target consensus for one US stock: mean, high and low target, the buy/hold/sell analyst counts, and about 13 months of month-by-month consensus history (mean target, rating split, and the high/avg/low band for the latest month). Use for “what is the Street price target on AAPL”, “how has the AAPL target moved this year”. Sourced live from Nasdaq’s public analyst data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | yes | US ticker symbol, e.g. “AAPL”, “NVDA”, “AMGN”. |
Example call
Arguments
{
"symbol": "AAPL"
}
curl
curl -X POST https://gateway.pipeworx.io/analyst-ratings/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analyst_price_targets","arguments":{"symbol":"AAPL"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('analyst_price_targets', {
"symbol": "AAPL"
});
Response shape
Always returns: symbol, price_target_mean, history
| Field | Type | Description |
|---|---|---|
symbol | string | |
id | string | |
price_target_mean | number | null | |
price_target_high | number | null | |
price_target_low | number | null | |
analysts_buy | number | null | |
analysts_hold | number | null | |
analysts_sell | number | null | |
history | array | |
source | string | |
retrieved_at | string |
Full JSON Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"id": {
"type": "string"
},
"price_target_mean": {
"type": [
"number",
"null"
]
},
"price_target_high": {
"type": [
"number",
"null"
]
},
"price_target_low": {
"type": [
"number",
"null"
]
},
"analysts_buy": {
"type": [
"number",
"null"
]
},
"analysts_hold": {
"type": [
"number",
"null"
]
},
"analysts_sell": {
"type": [
"number",
"null"
]
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"month": {
"type": "string"
},
"price_target_mean": {
"type": [
"number",
"null"
]
}
},
"required": [
"id"
]
}
},
"source": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"symbol",
"price_target_mean",
"history"
]
}
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 analyst-ratings pack
{
"mcpServers": {
"analyst-ratings": {
"url": "https://gateway.pipeworx.io/analyst-ratings/mcp"
}
}
}
See Getting Started for client-specific install steps.