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

NameTypeRequiredDescription
symbolstringyesUS 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

FieldTypeDescription
symbolstring
idstring
price_target_meannumber | null
price_target_highnumber | null
price_target_lownumber | null
analysts_buynumber | null
analysts_holdnumber | null
analysts_sellnumber | null
historyarray
sourcestring
retrieved_atstring
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.

Regenerated from source · build November 17, 2026