mcpField
U
U.S. Market Regime

U.S. Market Regime

Local
github.com/alicexixi85Other0Updated 1d ago
Repository

About U.S. Market Regime

U.S. Market Regime is an open-source MCP server that provides published end-of-day U.S. market context for Claude, Cursor and other MCP clients. It reports a GREEN, YELLOW or RED regime with underlying metrics and freshness information, for educational use rather than investment advice.

Key features

  1. 01Reports GREEN, YELLOW or RED regime
  2. 02Shows QQQ and VIX metrics
  3. 03Lists triggered rules and risk score
  4. 04Includes data age and stale-data warning
  5. 05Explains model states and limitations

Use cases

  1. 01Review end-of-day market context
  2. 02Check the rules behind a regime
  3. 03Verify feed freshness before analysis

MCP support

The MCP server exposes tools to retrieve the published market regime and explain its metrics and limitations. It reads a public feed and returns an error if the feed is unavailable rather than serving an old cached value.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "alicexixi85-us-market-regime": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alicexixi85/us-market-regime-mcp:0.1.0"
      ]
    }
  }
}
Run commanddocker run -i --rm ghcr.io/alicexixi85/us-market-regime-mcp:0.1.0

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/alicexixi85/us-market-regime-mcp:0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

U.S. Market Regime MCP

An open-source Model Context Protocol server that lets Claude, Cursor or any MCP client read the published end-of-day U.S. market regime (GREEN / YELLOW / RED) and the metrics behind it: QQQ vs. its 200-day average, drawdown from the high, VIX vs. its 20-day average, and distribution days over the last 25 sessions.

Zero dependencies, Python 3.10+. It is a read-only client for the public feed behind signal.usethelever.com.

Educational market context only. The server returns a description of the broad index environment. It does not recommend securities, give position sizes, or predict prices. Every response includes the as_of date and a disclaimer.

Tools

ToolReturns
get_market_regimeRegime, risk score (0-100), confidence, triggered rules, metrics, as_of / published_at, data age in days and a stale-data warning. If the feed cannot be reached the tool returns an error instead of an old cached value.
explain_regime_modelWhat each state and metric means, update cadence and the model's limits.

Install

git clone https://github.com/alicexixi85/us-market-regime-mcp.git

{
  "mcpServers": {
    "us-market-regime": {
      "command": "python3",
      "args": ["/absolute/path/to/us-market-regime-mcp/server.py"]
    }
  }
}

Docker: docker build -t us-market-regime-mcp . && docker run -i --rm us-market-regime-mcp

Terminal: python3 server.py --print

Example prompt: "What is today's market regime, how fresh is the data, and which rule triggered it?"

TradingView HUD

qqq_traffic_light_hud.pine is a separate, chart-only Pine Script v6 indicator that labels QQQ's trend context (supportive / choppy / downtrend) from EMAs, ATR and range efficiency. It is a simplified approximation and will not always match the published regime.

Related

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.