Does the result include sector flow or rotation phases?

No. The current v3 result ranks relative price returns for the selected horizon. It does not include options flow, rotation phases, or a weighted multi-horizon composite.

How many sectors are returned?

The fixed universe has eleven sector ETF proxies, but the result contains only one to eleven sectors with sufficient aligned history. Check expectedSectorCount, rankedSectorCount, and warnings.

Agent workflows

Sector Rotation MCP Tool for AI Agents

analyze-sector-rotation ranks supported members of a fixed eleven-sector US GICS ETF universe against SPY. It uses dividend-adjusted returns over either 21 or 63 trading days, selected by horizon, and reports relative-return rankings, coverage, and warnings.

Connect Pineify MCP View all MCP tools

MCP tool nameRead only

analyze-sector-rotation

Example prompt

Use Pineify analyze-sector-rotation for 3m. List the ranked sectors, relative returns, expected and ranked counts, and all coverage warnings.

Direct answer

What analyze-sector-rotation does

The expected universe contains eleven sector definitions. Only sectors with enough aligned history for the selected window enter the ranking; expectedSectorCount and rankedSectorCount expose the difference.

The current result contains price-based performance rather than options flow, phase groups, SMA50 trend, or a multi-horizon composite. Use a separate sector-flow tool when that context is needed.

Contract

What the agent sends and receives

Inputs

`horizon`: 1m or 3m; optional and defaults to 3m.
`detail`: compact or standard.
No custom ETF basket, weight, benchmark, date, or provider selector is accepted.

Structured output

`sector-rotation-v3` structured content with `sector-rotation-methodology-v3`.
Between one and eleven ranked sector records with horizon returns, benchmark-relative performance, observation counts, coverage, and as-of dates.
SPY benchmark coverage, expected and ranked sector counts, warnings, partial status, and methodology.

Capabilities

Where this MCP tool fits

Use a fixed sector universe

Keeps the eleven GICS/SPDR proxies and SPY benchmark versioned and deterministic.

Select one return horizon

Calculates adjusted sector and SPY returns over 21 trading days for 1m or 63 trading days for 3m, then subtracts the benchmark return.

Rank available sector evidence

Returns sequential ranks and percentile scores for the sectors with sufficient aligned history, with deterministic tie-breaking.

Agent workflow

A bounded call from question to review

1
Choose the fixed focus
Select 1m or 3m without redefining the universe.
2
Check benchmark coverage
Confirm adjusted SPY history before interpreting relative returns.
3
Review coverage before ranking
Read missing-sector warnings and the ranked count before treating the result as a complete eleven-sector comparison.

Prompt examples

Questions an agent can route to this tool

"Use Pineify analyze-sector-rotation for 3m. List the ranked sectors, relative returns, expected and ranked counts, and all coverage warnings."

"Compare 1m sector returns against SPY and identify sectors excluded for insufficient aligned 21-trading-day history."

Operator notes

How I review the result

I treat the ranking as historical relative-price evidence, not a sector forecast.

I keep separately requested options-premium flow distinct from price returns and ETF subscriptions or redemptions.

Boundaries to keep in the prompt

The universe and benchmark are fixed; custom baskets and arbitrary weighting are not supported.
Missing sector history can reduce the returned ranking below eleven records. Missing benchmark history or no eligible sectors produces an unavailable-data error.
Ranks and percentile scores describe the selected historical window, not future sector performance or allocation advice.

Pineify MCP provides financial information, code validation, and Journal recordkeeping. It does not provide investment advice, promise returns, send broker orders, or transfer funds. Review timestamps, source fields, code diagnostics, and risk assumptions before acting.

MCP tool family