Does the consensus label mean Pineify recommends the stock?

No. The label summarizes normalized point-in-time analyst calls. The result is informational evidence and does not predict returns or provide an investment recommendation.

Why can the implied median price change be null?

It remains null when a supported reference close is missing or the target and reference currencies cannot be compared safely. The warning and coverage fields explain the boundary.

How much analyst evidence is returned?

Aggregation uses the available bounded source set, while displayed active calls and recent actions are capped at 5 items in compact detail and 15 in standard detail.

Can AI predict stock prices with this MCP tool?

No. AI cannot predict stock prices with certainty, and this MCP tool does not promise future returns. It gives an agent bounded data or validation results that still require independent review, risk controls, and source checking.

Agent workflows

Stock Analyst Consensus MCP Tool for AI Agents

analyze-stock-analyst-consensus returns a bounded, point-in-time analyst-evidence snapshot for one supported US stock. It deduplicates active TipRanks calls by analyst, counts buy, hold, sell, and unclassified opinions, summarizes comparable price targets, and preserves no-coverage, partial, and warning states instead of inventing a recommendation.

Connect Pineify MCP View all MCP tools

MCP tool name

analyze-stock-analyst-consensus

Example prompt

Use Pineify analyze-stock-analyst-consensus for AAPL with lookback 1y and compact detail. Report the buy, hold, sell, and unclassified counts, then list every coverage warning without giving a recommendation.

Direct answer

What analyze-stock-analyst-consensus does

The workflow composes the relevant TipRanks datasets exposed through FMP into one decision-ready result; it does not expose seven raw provider endpoints as seven separate MCP tools.

Price-target statistics use only finite non-negative targets with a coherent currency. Historical comparisons use the supported prior market close, and the implied median change stays null when the reference price or currency is not comparable.

Contract

What the agent sends and receives

Inputs

`symbol`: one exact bare ticker for a supported active US-listed company or ADR.
`asOfDate`: optional real calendar date no later than the current New York date; omitted means the current New York date.
`lookback: "30d" | "90d" | "1y" | "3y"`: optional; `1y` is the default and three years is the maximum retained window.
`detail: "compact" | "standard"`: optional; `standard` is the default. Compact returns at most 5 evidence items per list and standard at most 15.

Structured output

`stock-analyst-consensus-v1` structured content with `stock-analyst-consensus-methodology-v1`, the effective date range, retrieval time, and informational-only marker.
Resolved stock identity; covered or no-coverage consensus; bounded price-target statistics and optional reference-price delta; activity, active calls, and recent actions.
Per-section coverage, source records, warnings, collection totals, invalid/truncated counts, and partial status make missing or degraded evidence explicit.

Capabilities

Where this MCP tool fits

Measure point-in-time consensus

Returns buy, hold, sell, rated-analyst, and unclassified counts after defensively deduplicating active calls by expertUID.

Summarize comparable price targets

Calculates low, median, mean, and high targets plus an optional reference-price delta only when price and currency evidence is coherent.

Keep supporting evidence bounded

Returns active calls, recent actions, activity coverage, sources, warnings, and partial status with fixed compact or standard limits.

Agent workflow

A bounded call from question to review

1
Choose an exact stock and time boundary
Send a bare ticker and optionally set an as-of date, supported lookback, and detail level.
2
Read coverage before the label
Check the consensus and collection coverage, including unclassified opinions and no-coverage status, before interpreting bullish, neutral, or bearish.
3
Validate price comparability
Use the target currency, reference price date, warnings, and nullable implied change to avoid comparing incompatible evidence.

Prompt examples

Questions an agent can route to this tool

"Use Pineify analyze-stock-analyst-consensus for AAPL with lookback 1y and compact detail. Report the buy, hold, sell, and unclassified counts, then list every coverage warning without giving a recommendation."

"Analyze MSFT analyst consensus as of 2026-06-30 over 90d at standard detail. Compare the median target with the reference close only if the currencies match."

"Get the 3y point-in-time analyst consensus for NVDA. Separate active calls from recent actions and keep no-coverage or partial sections explicit."

Operator notes

How I review the result

I treat the consensus label as a normalized summary of observed analyst calls, not as Pineify investment advice or a forecast.

I keep unknown recommendation labels in the unclassified count and preserve invalid or truncated record counts rather than silently dropping the data-quality signal.

Boundaries to keep in the prompt

Provider coverage, entitlements, publication timing, and corrections can make sections unavailable or partial. The result is not guaranteed to include every analyst or action.
The supported lookback is capped at the most recent three years; the tool does not promise full historical coverage.
Cross-currency or otherwise incomparable price-target evidence produces null comparison fields with a warning rather than a converted value.
The tool does not predict returns, execute trades, rank securities, or provide personalized investment advice.

Pineify MCP is an information and code-validation tool, not investment advice. It does not promise returns, place trades, or modify a portfolio. Review timestamps, source fields, code diagnostics, and risk assumptions before acting.

MCP tool family