`analyst_upgrades_today`

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_upgrades_today for the schema, then POST the same URL with its arguments for the data.

Today’s US stock analyst upgrades and downgrades, market-wide: every ratings action Wall Street brokerages published this session, with the ticker, the brokerage, the analyst, the old and new rating and the old and new price target. Use this for “which stocks were upgraded today”, “analyst downgrades today”, “today’s price target changes” and “what did analysts initiate coverage on”. Filter with action (upgrade, downgrade, initiated, price_target, reiterated) or narrow to one ticker with symbol. Sourced live from MarketBeat’s daily ratings tables; covers US-listed equities (NYSE, Nasdaq, NYSE American, OTC) by default.

Parameters

Name	Type	Required	Description
`action`	string	no	Which ratings action to return. “upgrade” = rating raised, “downgrade” = rating cut, “initiated” = new coverage started, “price_target” = target raised/lowered/set with no rating change, “reiterated” = rating restated. Default “all”.
`symbol`	string	no	Optional ticker filter, e.g. “AAPL”. Case-insensitive; returns only that symbol’s actions from today.
`us_only`	boolean	no	Keep only US-listed exchanges (NYSE, NASDAQ, NYSE American, OTC). Default true — the combined feed also carries Toronto and London listings.
`limit`	number	no	Maximum rows to return (default 50, max 400).

Example call

Arguments

{
  "action": "upgrade",
  "limit": 10
}

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_upgrades_today","arguments":{"action":"upgrade","limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('analyst_upgrades_today', {
  "action": "upgrade",
  "limit": 10
});

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.

analyst_upgrades_today