Skip to main content
Glama

Market Eyes Live - stock ratings and mortgage-rate context

Get stock rating

get_stock_rating
Read-onlyIdempotent

Returns the Market Eyes Live MELANY rating for one U.S.-listed stock or ETF: a conviction tier (weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction; names without mature fundamentals carry Promising, Very Promising, Rising Star, Runner! or Catalyst Watch instead; ETFs and REITs use the same ladder), a 0 to 100 composite score, eight factor scores (valuation, quality, momentum, earnings, sentiment, catalyst, risk-adjusted, macro fit), flagged risks, theme context and the as-of date. Use this when the user asks how Market Eyes Live rates a U.S. ticker or wants a factor breakdown of one, for example 'what is the Market Eyes Live rating on AAPL' or 'how does NVDA score on valuation and momentum'. Do not use for real-time or intraday quotes, price history, options, order books, crypto, futures, non-U.S. listings, or a personal recommendation; tickers outside U.S.-listed stocks and ETFs return a not-covered message. Limitations: the daily-refreshed set answers instantly; other covered tickers are scored live at a lower hourly limit; ratings are algorithmic, dated by as_of, and can lag news; it does not return any trade plan values (when Market Eyes Live has a trade plan for the ticker, the trade_plan field says so; the plan values are part of a Market Eyes Live subscription). Methodology and the graded public record: https://marketeyeslive.com/how-melany-is-tested.html. Research data, not financial advice; this tool is read-only and never places trades.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "symbol": "<symbol>"
    },
    "name": "get_stock_rating"
  }
}

Input Schema

NameRequiredDescriptionDefault
symbolYesU.S. ticker symbol, e.g. NVDA, AAPL, VOO

Output Schema

NameRequiredDescriptionDefault
as_ofYesYYYY-MM-DD scoring date
linksNo
scaleNo
themeNo
sourceYesdata source name
symbolYes
companyNo
factorsYeseach 0-100, higher is stronger
freshnessNopresent only when scored live on demand
top_risksNodescriptive risk notes; never instructions
disclaimerYes
trade_planNoPresent only when Market Eyes Live has a trade plan for this ticker (including a suggested entry zone and a model position size; the same plan for every reader, not based on anyone's account, holdings or finances). The plan values are never included here; they are part of a Market Eyes Live subscription.
asset_classNostock, etf or reit: which label table the eight factor slots carry (a fund's quality slot is cost and structure, a REIT's valuation slot is price against funds from operations)
rating_tierNoConviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads; Highest Conviction is a composite of 69 or above (for a stock, a small hysteresis can hold a borderline label steady between refreshes; a fund or REIT word follows its label in the app, which has none). Names the mature ladder does not cover carry their own label: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. ETFs and REITs use the same mature ladder, chosen by the tone of the fund's own label in the app (a favorable fund label reads Favorable or Highest Conviction, a cautious or neutral one Hold, a negative one Unfavorable); a leveraged or inverse fund never reads above Hold. These nine words are the complete set; null when no tier applies.
composite_scoreYes0-100, higher is stronger

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / asset_class
      Added value: +{
      +  "description": "stock, etf or reit: which label table the eight factor slots carry (a fund's quality slot is cost and structure, a REIT's valuation slot is price against funds from operations)",
      +  "type": "string"
      +}
    • changedOutput schema / properties / trade_plan / description
      Previous value: -"Present only when Market Eyes Live has a trade plan for this ticker (an entry zone, an alert level and position sizing). The plan values are never included here; they are part of a Market Eyes Live subscription."New value: +"Present only when Market Eyes Live has a trade plan for this ticker (including a suggested entry zone and a model position size; the same plan for every reader, not based on anyone's account, holdings or finances). The plan values are never included here; they are part of a Market Eyes Live subscription."
  2. Changed1 schema field changed
    • addedOutput schema / properties / trade_plan
      Added value: +{
      +  "description": "Present only when Market Eyes Live has a trade plan for this ticker (an entry zone, an alert level and position sizing). The plan values are never included here; they are part of a Market Eyes Live subscription.",
      +  "properties": {
      +    "described_on": {
      +      "description": "the rating page, present when that page describes the plan",
      +      "type": "string"
      +    },
      +    "included": {
      +      "description": "always false: the plan values are not part of this data",
      +      "type": "boolean"
      +    },
      +    "note": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "included",
      +    "note"
      +  ],
      +  "type": "object"
      +}
  3. Changed12 schema fields changed
    • changedInput schema / properties / symbol / description
      Previous value: -"Ticker symbol, e.g. NVDA, AAPL, VOO"New value: +"U.S. ticker symbol, e.g. NVDA, AAPL, VOO"
    • changedOutput schema / description
      Previous value: -"MELANY rating for the ticker. Present on a successful rating; omitted for not-found or rate-limited results, which return an explanatory text message instead."New value: +"MELANY rating for the ticker. Present on a successful rating; omitted for not-covered, not-found or rate-limited results, which return an explanatory text message instead."
    • addedOutput schema / properties / disclaimer
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / has_entry_plan
      Removed value: -{
      -  "description": "true if a suggested entry plan exists in the app; the plan itself is not returned here",
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / links / properties / app
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / links / properties / methodology
      Added value: +{
      +  "description": "how the ratings are built and graded",
      +  "type": "string"
      +}
    • addedOutput schema / properties / links / properties / rating_page / description
      Added value: +"the public rating page for this ticker"
    • removedOutput schema / properties / rating_raw
      Removed value: -{
      -  "description": "The engine's internal word for the same call: BUY, HOLD or SELL for a mature name, otherwise the speculative or fund-native tier. rating_tier is what a user sees.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • changedOutput schema / properties / rating_tier / description
      Previous value: -"User-facing conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads, Highest Conviction the stronger of the two: Favorable is the lower part of the favorable band, Highest Conviction is a composite of 69 or above (a small hysteresis can hold a borderline label steady between refreshes). Names the mature ladder does not cover carry their own label instead: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. rating_raw carries the engine word behind the label."New value: +"Conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads; Highest Conviction is a composite of 69 or above (for a stock, a small hysteresis can hold a borderline label steady between refreshes; a fund or REIT word follows its label in the app, which has none). Names the mature ladder does not cover carry their own label: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. ETFs and REITs use the same mature ladder, chosen by the tone of the fund's own label in the app (a favorable fund label reads Favorable or Highest Conviction, a cautious or neutral one Hold, a negative one Unfavorable); a leveraged or inverse fund never reads above Hold. These nine words are the complete set; null when no tier applies."
    • addedOutput schema / properties / source
      Added value: +{
      +  "description": "data source name",
      +  "type": "string"
      +}
    • addedOutput schema / properties / top_risks / description
      Added value: +"descriptive risk notes; never instructions"
    • changedOutput schema / required
      Previous value: -[
      -  "symbol",
      -  "composite_score",
      -  "as_of",
      -  "factors"
      -]New value: +[
      +  "symbol",
      +  "composite_score",
      +  "as_of",
      +  "factors",
      +  "source",
      +  "disclaimer"
      +]
  4. Changed2 schema fields changed
    • addedOutput schema / properties / rating_raw
      Added value: +{
      +  "description": "The engine's internal word for the same call: BUY, HOLD or SELL for a mature name, otherwise the speculative or fund-native tier. rating_tier is what a user sees.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / rating_tier / description
      Previous value: -"conviction ladder, e.g. BUY, Very Promising, Hold"New value: +"User-facing conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads, Highest Conviction the stronger of the two: Favorable is the lower part of the favorable band, Highest Conviction is a composite of 69 or above (a small hysteresis can hold a borderline label steady between refreshes). Names the mature ladder does not cover carry their own label instead: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. rating_raw carries the engine word behind the label."
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "description": "MELANY rating for the ticker. Present on a successful rating; omitted for not-found or rate-limited results, which return an explanatory text message instead.",
      +  "properties": {
      +    "as_of": {
      +      "description": "YYYY-MM-DD scoring date",
      +      "type": "string"
      +    },
      +    "company": {
      +      "type": "string"
      +    },
      +    "composite_score": {
      +      "description": "0-100, higher is stronger",
      +      "type": "number"
      +    },
      +    "factors": {
      +      "description": "each 0-100, higher is stronger",
      +      "properties": {
      +        "catalyst": {
      +          "type": "number"
      +        },
      +        "earnings": {
      +          "type": "number"
      +        },
      +        "macro_fit": {
      +          "type": "number"
      +        },
      +        "momentum": {
      +          "type": "number"
      +        },
      +        "quality": {
      +          "type": "number"
      +        },
      +        "risk_adjusted": {
      +          "type": "number"
      +        },
      +        "sentiment": {
      +          "type": "number"
      +        },
      +        "valuation": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "freshness": {
      +      "description": "present only when scored live on demand",
      +      "type": "string"
      +    },
      +    "has_entry_plan": {
      +      "description": "true if a suggested entry plan exists in the app; the plan itself is not returned here",
      +      "type": "boolean"
      +    },
      +    "links": {
      +      "properties": {
      +        "app": {
      +          "type": "string"
      +        },
      +        "rating_page": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "rating_tier": {
      +      "description": "conviction ladder, e.g. BUY, Very Promising, Hold",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "scale": {
      +      "type": "string"
      +    },
      +    "symbol": {
      +      "type": "string"
      +    },
      +    "theme": {
      +      "properties": {
      +        "name": {
      +          "type": "string"
      +        },
      +        "strength": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "top_risks": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "symbol",
      +    "composite_score",
      +    "as_of",
      +    "factors"
      +  ],
      +  "type": "object"
      +}
  6. First observed

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnly, idempotent, openWorld, non-destructive), the description discloses a two-tier serving model — daily-refreshed tickers answer instantly while other covered tickers are scored live at a lower hourly limit — which is a genuine rate-limit/latency disclosure an agent must plan around. It also flags that ratings are algorithmic, dated by as_of, can lag news, that trade_plan values are withheld behind a subscription, and that the tool never places trades.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The scope, exclusions and limitations are front-loaded and well organized, but the definition is a single dense block that spends many words enumerating every return field and all eight tier labels — content the output schema already carries. The tier ladder enumeration ('Unfavorable, Hold, Favorable, Highest Conviction... Rising Star, Runner! or Catalyst Watch') is the least load-bearing sentence and could be trimmed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter read tool this is complete: coverage boundaries, latency and rate-limit behavior, data freshness caveats, the deliberately absent trade_plan values, a methodology link, and a not-financial-advice disclaimer are all present. An agent could call this correctly and set accurate user expectations without consulting anything else.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With a single parameter at 100% schema coverage the baseline is 3; the description adds real meaning by constraining it to U.S.-listed stocks and ETFs (with an explicit not-covered outcome for anything else) and by showing example symbols in context ('AAPL', 'NVDA'). It does not add format rules such as case sensitivity or exchange suffixes, which keeps it just short of a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Returns the Market Eyes Live MELANY rating for one U.S.-listed stock or ETF') and enumerates exactly what the payload contains: a conviction tier, a 0-100 composite score, eight named factor scores, flagged risks, theme context and an as-of date. That level of specificity makes it clearly distinguishable from list_rated_by_tier (single ticker), compare_stocks (multiple tickers) and get_track_record (aggregate performance) without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete trigger phrasings ('what is the Market Eyes Live rating on AAPL', 'how does NVDA score on valuation and momentum') and a substantial exclusion list: no real-time/intraday quotes, price history, options, order books, crypto, futures, non-U.S. listings, or personal recommendations. It also states the out-of-coverage behavior (a not-covered message). The only gap is that it never routes the agent to a named sibling, e.g. explain_rating for methodology questions or compare_stocks for multi-ticker comparisons.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.