What happens when breadth is unavailable?

Breadth is required, so the workflow returns an insufficient status instead of forcing a market-regime classification.

Does risk-on mean I should buy?

No. It is a bounded description of current evidence, not a ticker recommendation, allocation target, or trade instruction.

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

Market Regime MCP Tool for AI Agents

detect-market-regime combines up to five versioned evidence dimensions: SPY/QQQ trend, VIX state, S&P 500 breadth, sector participation, and market tide. The first three are required; when any required dimension is unavailable, the workflow returns insufficient instead of forcing a risk-on, risk-off, mixed, or transitional label.

Connect Pineify MCP View all MCP tools

MCP tool name

detect-market-regime

Example prompt

Use Pineify detect-market-regime for the medium term and explain all five dimensions.

Direct answer

What detect-market-regime does

Each available dimension contributes only -1, 0, or 1. Scores of 3 or higher are risk-on, -3 or lower are risk-off, and recent SPY50 or VIX threshold crossings can mark a transitional state.

The result reuses normalized market briefing and sector-rotation facts. It does not add ticker picks, actions, allocation targets, or predictions.

Contract

What the agent sends and receives

Inputs

`horizon`: short-term or medium-term; defaults to medium-term.
`detail`: compact or standard.
No ticker list, score weights, custom thresholds, action, or forecast parameter is accepted.

Structured output

`market-regime-v1` structured content.
Status, classification, score from -5 to 5, three to five dimensions, and crossing evidence.
Coverage, source times, warnings, implications, and versioned thresholds.

Capabilities

Where this MCP tool fits

Build five bounded dimensions

Keeps trend, volatility, breadth, sector, and market-tide evidence independently inspectable.

Fail honestly on required gaps

Returns insufficient when benchmark trend, VIX, or breadth coverage is unavailable or stale.

Detect recent transitions

Checks the latest five trading days for SPY 50-day trend and VIX 20/25 threshold crossings.

Agent workflow

A bounded call from question to review

1
Choose the evidence horizon
Request short-term or medium-term context.
2
Verify required dimensions
Check trend, VIX, and breadth availability before using the classification.
3
Read score and crossings together
Separate broad alignment from recent transition evidence.

Prompt examples

Questions an agent can route to this tool

"Use Pineify detect-market-regime for the medium term and explain all five dimensions."

"Check the short-term regime and return insufficient if required trend, VIX, or breadth data is missing."

Operator notes

How I review the result

I preserve a legal zero score as neutral evidence, not missing data.

I describe the label as current observed context rather than a market forecast.

Boundaries to keep in the prompt

Optional sector or market-tide evidence may be partial without blocking required classification.
Fixed thresholds and five-day crossing rules cannot be customized.
The classification is informational and does not recommend securities, positions, or timing.

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