analyst_ratings_for_symbol
Pack: analyst-ratings · Endpoint: https://gateway.pipeworx.io/analyst-ratings/mcp
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, or use one-click install buttons:
{
"mcpServers": {
"analyst-ratings": {
"url": "https://gateway.pipeworx.io/analyst-ratings/mcp"
}
}
}
See Getting Started for client-specific install steps.