analyst_ratings_for_symbol
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_ratings_for_symbol for the schema, then POST the same URL with its arguments for the data.
Wall Street consensus analyst rating for one US stock: the mean rating (Buy/Hold/Sell), how many analysts cover it, and the list of brokerage firms publishing recommendations on it. Use for “what do analysts think of NVDA”, “who covers Apple”, “consensus rating for TSLA”. Sourced live from Nasdaq’s public analyst endpoint. For what analysts DID today (upgrades, downgrades, price-target changes) use analyst_upgrades_today with symbol instead — this tool returns the standing consensus, not the day’s actions.
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_ratings_for_symbol","arguments":{"symbol":"AAPL"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('analyst_ratings_for_symbol', {
"symbol": "AAPL"
});
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.