# Zensei MCP [Verified owner] [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://www.zensei.com/  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/zensei-mcp

## Description
Live sector rotation data for AI agents. Tools: sector rotation status (100+ sectors classified as leading, lagging, improving or weakening vs the S&P 500), sector-to-stock drill-down (the stocks driving each move), and macro regime (Zensei Index risk-on / risk-off read). Remote server, OAuth with a Zensei account.

## Tools
Capabilities this server exposes over MCP:

- **zensei_index_about** — What the Zensei Index is, how to read the score, how it is built, and what this server serves (free and Premium). Same wording as the website FAQ. Call it once before interpreting any score.
- **zensei_index_today** — Today's Zensei Index for U.S. equities: the final score, its regime label, and the three layer scores (structural conditions, tactical filters, regime confirmations). The Zensei Index is a RISK score from 0 to 100: LOWER IS HEALTHIER. 0-20 Supportive, 20-40 Vulnerable, 40-70 Stressed, 70-100 Restrictive. A rising score means conditions are deteriorating, not improving. Call zensei_index_indicators to see why the score sits where it does.
- **zensei_index_indicators** — The ten indicators behind today's Zensei Index, each with its current status, the layer it scores into, its weight in that layer, and the same explanation the website shows. Use it to explain why the index sits where it does. Indicator statuses run from healthiest to most stressed: Clear or Inactive (no stress), Watch (early warning), Stress (confirmed stress), Activated or Danger (full signal). Calibrating means not enough data yet; Unknown means no data.
- **zensei_index_summary** — The latest written summary of the Zensei Index, with the score and regime it was written for. A summary is rewritten only when the indicators change. Check `stale` and `ageDays` before quoting it as today's view, and prefer zensei_index_today for the current number. The Zensei Index is a RISK score from 0 to 100: LOWER IS HEALTHIER. 0-20 Supportive, 20-40 Vulnerable, 40-70 Stressed, 70-100 Restrictive. A rising score means conditions are deteriorating, not improving.
- **zensei_index_history** — Daily Zensei Index scores for the last `days` calendar days, with the regime of each day. Free access covers the last 31 days; Premium covers up to 3650 days. The Zensei Index is a RISK score from 0 to 100: LOWER IS HEALTHIER. 0-20 Supportive, 20-40 Vulnerable, 40-70 Stressed, 70-100 Restrictive. A rising score means conditions are deteriorating, not improving.
- **zensei_sectors_scan** — How each sector ETF performs against the S&P 500 (SPY), placed in four quadrants by its 3-month (X) and 1-month (Y) change vs SPY: Outperformers (ahead on both), Emerging (behind over 3 months, ahead over 1 month), Cooling (ahead over 3 months, behind over 1 month) and Underperformers (behind on both). Also gives short-term momentum, relative-strength trend and returns over 1w to 1y. Free access covers the 11 broad S&P 500 sectors; Premium adds 104 thematic and industry sectors. Use zensei_sector_detail for one sector's holdings.
- **zensei_sector_detail** — One sector ETF in depth: its quadrant, momentum and returns vs SPY, valuation, and its largest holdings (up to 25). For each holding: weight, quadrant against the sector ETF (not against SPY), momentum, 1-month change and the gap to the sector. The 11 broad S&P 500 sectors (XLK, XLF, XLV, XLE, XLI, XLY, XLP, XLU, XLB, XLRE, XLC) are free; every other sector needs Premium. Get symbols from zensei_sectors_scan.
- **zensei_stock_detail** — How one stock performs against a sector ETF that holds it (its 'lens'): returns over 1w to 1y and the gap to the sector, relative-strength trend, valuation, next earnings date, and every tracked sector that holds it with its quadrant there. Without `sector`, the free tier uses a broad S&P 500 sector that holds the stock and Premium uses its largest-weight sector.
- **zensei_search** — Find sector ETFs and stocks tracked by Zensei by ticker or name. Returns each stock with the sector ETFs that hold it, largest weight first. Needs Zensei Premium.
- **zensei_my_watchlist** — The signed-in user's saved symbols on Zensei, with the sector each one is pinned to. Reads the "Favorites" list unless `list` names another. Needs a Zensei account; custom lists are a Premium feature. Pass each symbol to zensei_stock_detail or zensei_sector_detail for figures.
- **zensei_view_sector** — Used by the Zensei sector map view to open one sector's holdings inside the view. Not for direct use: call zensei_sector_detail instead.
- **zensei_view_indicators** — Used by the Zensei Index view to draw the ten indicator charts inside the view. Not for direct use: call zensei_index_indicators instead.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What Zensei MCP does

Zensei MCP gives AI agents access to Zensei's market analysis for U.S. equities. Its tools cover three main areas: the Zensei Index, sector rotation, and security-level drill-downs.

The Zensei Index is a risk score from 0 to 100, where lower values indicate healthier conditions. Its regimes are Supportive at 0–20, Vulnerable at 20–40, Stressed at 40–70, and Restrictive at 70–100. A rising score indicates worsening conditions. Agents can retrieve the current score, its three layer scores, the ten underlying indicators, historical readings, and the latest written interpretation.

Sector tools compare sector ETFs with SPY across multiple time periods. The scan places sectors into Outperformers, Emerging, Cooling, or Underperformers based on three-month and one-month relative performance. Detail tools add valuation, momentum, returns, and holdings. Stock detail applies a sector “lens” to compare an individual stock with a sector ETF that holds it.

## How it works

The service is remote and uses OAuth with a Zensei account. Agents call MCP tools to retrieve current or historical data rather than accessing a local database.

Call `zensei_index_about` before interpreting Index values. It explains the score, construction, and service tiers. Use `zensei_index_today` for the current number, `zensei_index_indicators` to explain the contributing signals, and `zensei_index_summary` for the latest written commentary. Check the summary's freshness fields before treating it as today's view.

For sector analysis, start with `zensei_sectors_scan`, then pass a sector symbol to `zensei_sector_detail`. Use `zensei_stock_detail` for a stock-level comparison. `zensei_search` can find tracked symbols, while `zensei_my_watchlist` reads saved symbols from a user's Zensei account. Two view-oriented tools, `zensei_view_sector` and `zensei_view_indicators`, support Zensei's own views and should not be used for ordinary analysis.

## Setup and configuration

Connect the remote MCP endpoint and complete OAuth authentication with a Zensei account. A Zensei account is required for watchlist access. The available data depends on the account tier: free access includes the 11 broad S&P 500 sectors, 31 calendar days of Index history, and the free Index and sector tools; Premium expands thematic and industry sector coverage, history, search, and custom watchlists.

The broad sector ETFs available in the free tier are XLK, XLF, XLV, XLE, XLI, XLY, XLP, XLU, XLB, XLRE, and XLC. Sector symbols for detailed analysis can be obtained from the sector scan.

## Tools and capabilities

- Retrieve the current Zensei Index, regime, and layer scores.
- Inspect the ten indicators, their statuses, weights, layers, and explanations.
- Review daily Index history for the available time range.
- Scan sector performance against SPY across one week to one year.
- Examine sector valuations, momentum, returns, and up to 25 largest holdings.
- Compare a stock with its holding sector and view its sector exposures.
- Search tracked stocks and sector ETFs, or read a saved Zensei watchlist.

## Limitations and notes

Index values require careful interpretation: the score measures risk, not market health in the usual positive-score sense. “Clear” or “Inactive” indicates no stress, while Watch, Stress, Activated, and Danger represent progressively stronger signals. Calibrating means there is not enough data yet, and Unknown means no data is available.

The Index summary may lag the current score because it is rewritten only when indicators change. Use the current Index tool for the latest number and consult the summary freshness fields before quoting its text.

Sector detail requires a symbol from the tracked sector universe. Stock detail chooses a broad S&P 500 sector by default on the free tier; Premium uses the largest-weight sector when no sector is supplied.

_Full upstream README: https://allmcps.com/mcp/zensei-mcp/readme_

