Skip to main content
Glama
Sign In
U.S. Market Regime Traffic Light MCP

U.S. Market Regime Traffic Light MCP

by alicexixi85
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Tool

Returns

get_market_regime

Regime, 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_model

What each state and metric means, update cadence and the model's limits.

Related MCP server: fahali-mcp

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

Available Tools

2 tools
explain_regime_modelA
Read-only

Explain what GREEN / YELLOW / RED mean, what each metric measures, update cadence and the model's limits.

Inputs: no named parameters.

get_market_regimeA
Read-only

Get the latest published end-of-day U.S. market regime (GREEN / YELLOW / RED), risk score, QQQ/VIX/distribution-day metrics, triggered rules and data freshness from signal.usethelever.com.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly separate roles: get_market_regime returns data, while explain_regime_model returns documentation about semantics, cadence and limits. An agent can trivially decide which to call with no overlap in outputs.

    Naming Consistency5/5

    Both names follow a predictable snake_case verb_noun pattern (get_/explain_ + domain object) and are self-describing. The convention is uniform across the entire surface.

    Tool Count4/5

    The server exposes a single published gauge, so a data tool plus a model-explanation tool is a reasonable minimal scope. Two tools is on the thin side, but each earns its place rather than being redundant.

    Completeness3/5

    Only the latest end-of-day regime is reachable; there is no way to query historical regimes, a date range, or a time series of risk scores, which are natural follow-on needs for this domain. Core read access and interpretation are covered, so agents can work but hit a wall on trend questions.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • rays-mcp

      ivyyy0601
      F
      license
      Not graded
      quality
      D
      maintenance
      Exposes global market breadth, volume, RSI, volatility, and sentiment for 12 major equity indices (US + Asia) via 5 tools.
      -

    • fahali-mcp

      Future-Legends-Inc
      A
      license
      B
      quality
      B
      maintenance
      Market-intelligence MCP: 18 detection engines over 9,200+ instruments with calibrated uncertainty and outcome-verified provenance. Informational only, not financial advice.
      58
      MIT

    • Market Regime Oracle

      aggreyeric
      A
      license
      Not graded
      quality
      B
      maintenance
      Classifies BTC market into 5 regimes (Risk-On, Range-Bound, Risk-Off, Capitulation, Euphoria) with target exposure and posture, enabling risk management decisions.
      MIT