StockLens

Get Company Score

get_market_summary

Read-onlyIdempotent

One company's latest nightly StockLens score: the composite score (0 to 100) and its rating word, the domain scores with their grade words, the named signals that most shaped the reading (up to three, each with its evidence), the business-model lens where one applies, and any domain that was not scored in it. Use the rating word for the company and grade words only for a domain. A higher Risk score means a stronger risk posture and less downside concern. Without an account, scores answer for the 600 largest companies by market value; a signed-in account also reaches any company in its own portfolios. A result with a status other than scored is an answer, not an error; do not retry it unchanged. Relay its message; not_in_surface means the company is scored and outside the caller's reach, never that StockLens has no analysis. Then act on next_step: for ask_user, ask the person and call the named tool only if they agree; mention an offer on a scored result at most once per conversation. Every result carries freshness; a stale result is StockLens's last computed reading for that listing, not last night's, and should be quoted with its date. When freshness.requested_ticker is present, say which listing was served and what was asked. One ticker per call. To compare companies the person names, call it once for each. For any other top, best, worst or filtered request call discover_stocks, and never choose the companies for a ranking yourself.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`ticker`	Yes	Stock ticker symbol (e.g. AAPL MSFT TSLA). Exactly one ticker per call.
`exchange`	No	Exchange code (e.g. NASDAQ NYSE). Optional. Resolved automatically if omitted.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`lens`	No
`scope`	Yes
`rating`	No
`sector`	No
`status`	Yes
`ticker`	Yes
`message`	No
`exchange`	No
`industry`	No
`freshness`	No
`next_step`	No
`candidates`	No
`key_drivers`	No
`company_name`	No
`analysis_date`	No
`domain_scores`	No
`config_context`	No
`composite_score`	No
`domain_coverage`	No
`watchlist_offered`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 2, 2026

addedOutput schema / properties / domain_coverage / properties / sentiment_sources_note

Added value: +{
+  "description": "The Sentiment evidence this reading did not use and why, as one sentence to relay as given, for example: Evidence not read in this analysis: earnings calls (none found recently).",
+  "type": "string"
+}

removedOutput schema / properties / domain_coverage / required
```
Removed value: -[
-  "not_scored"
-]
```

Changed1 schema field changedSep 26, 2026

changedInput schema / properties / ticker / pattern

Previous value: -"^[A-Za-z][A-Za-z.\\-]{0,9}$"New value: +"^[A-Za-z0-9][A-Za-z0-9.\\-]{0,19}$"

Changed4 schema fields changedSep 25, 2026

addedOutput schema / properties / domain_coverage

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "not_scored": {
+      "items": {
+        "enum": [
+          "Fundamental",
+          "Technical",
+          "Risk",
+          "Sentiment",
+          "Macro"
+        ],
+        "type": "string"
+      },
+      "type": [
+        "null",
+        "array"
+      ]
+    }
+  },
+  "required": [
+    "not_scored"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

addedOutput schema / properties / key_drivers

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "type": [
+          "null",
+          "string"
+        ]
+      },
+      "domain": {
+        "type": [
+          "null",
+          "string"
+        ]
+      },
+      "kind": {
+        "enum": [
+          "SUPPORTIVE",
+          "HEADWIND",
+          "MIXED",
+          "COVERAGE_GAP",
+          "NEUTRAL_NOT_MATERIAL"
+        ],
+        "type": "string"
+      },
+      "label": {
+        "type": "string"
+      },
+      "metric": {
+        "type": [
+          "null",
+          "string"
+        ]
+      }
+    },
+    "required": [
+      "kind",
+      "label"
+    ],
+    "type": "object"
+  },
+  "type": [
+    "null",
+    "array"
+  ]
+}

addedOutput schema / properties / lens

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "label": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "label"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

removedOutput schema / properties / watchlist

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "message": {
-      "type": "string"
-    },
-    "tool": {
-      "type": "string"
-    },
-    "tracked": {
-      "type": "boolean"
-    }
-  },
-  "required": [
-    "tracked",
-    "tool",
-    "message"
-  ],
-  "type": [
-    "null",
-    "object"
-  ]
-}

Changed18 schema fields changedSep 25, 2026

changedInput schema / properties / exchange / description

Previous value: -"Exchange code (e.g. NASDAQ NYSE). Optional - resolved automatically if omitted."New value: +"Exchange code (e.g. NASDAQ NYSE). Optional. Resolved automatically if omitted."

addedInput schema / properties / exchange / enum

Added value: +[
+  "NYSE",
+  "NASDAQ",
+  "AMEX",
+  "OTC",
+  "CBOE",
+  "TSX",
+  "TSXV",
+  "CNQ",
+  "NEO",
+  "MEX",
+  "B3",
+  "SANTIAGO",
+  "BUE",
+  "BVC",
+  "LSE",
+  "EURONEXT_PARIS",
+  "EURONEXT_AMSTERDAM",
+  "EURONEXT_BRUSSELS",
+  "EURONEXT_LISBON",
+  "EURONEXT_DUBLIN",
+  "XETRA",
+  "SIX",
+  "BME",
+  "MILAN",
+  "OSLO",
+  "OMX_STOCKHOLM",
+  "OMX_HELSINKI",
+  "OMX_COPENHAGEN",
+  "WSE",
+  "VIE",
+  "ATH",
+  "PRA",
+  "BUD",
+  "IST",
+  "ICE",
+  "RIS",
+  "TAL",
+  "MCX",
+  "TSE",
+  "HKEX",
+  "SHANGHAI",
+  "SHENZHEN",
+  "ASX",
+  "TWSE",
+  "SGX",
+  "NSE",
+  "KRX",
+  "BSE",
+  "KOE",
+  "JKT",
+  "KLS",
+  "SET",
+  "NZE",
+  "HOSE",
+  "TWO",
+  "TADAWUL",
+  "JSE",
+  "TLV",
+  "DFM",
+  "EGX",
+  "DOH",
+  "KUW"
+]

changedInput schema / properties / ticker / description

Previous value: -"Stock ticker symbol (e.g. AAPL MSFT TSLA)"New value: +"Stock ticker symbol (e.g. AAPL MSFT TSLA). Exactly one ticker per call."

addedOutput schema / properties / candidates

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "company_name": {
+        "type": "string"
+      },
+      "exchange": {
+        "type": "string"
+      },
+      "ticker": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "ticker",
+      "exchange",
+      "company_name"
+    ],
+    "type": "object"
+  },
+  "type": [
+    "null",
+    "array"
+  ]
+}

changedOutput schema / properties / composite_score / type

Previous value: -"number"New value: +[
+  "null",
+  "number"
+]

removedOutput schema / properties / config_context / properties / config_name
```
Removed value: -{
-  "type": [
-    "null",
-    "string"
-  ]
-}
```
removedOutput schema / properties / config_context / properties / config_version
```
Removed value: -{
-  "type": [
-    "null",
-    "string"
-  ]
-}
```

changedOutput schema / properties / config_context / type

Previous value: -"object"New value: +[
+  "null",
+  "object"
+]

removedOutput schema / properties / data_source
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / domain_scores / items / properties / display_name
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / domain_scores / items / required

Previous value: -[
-  "domain",
-  "display_name",
-  "score",
-  "grade"
-]New value: +[
+  "domain",
+  "score",
+  "grade"
+]

addedOutput schema / properties / freshness

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "age_days": {
+      "type": "integer"
+    },
+    "last_scored": {
+      "type": "string"
+    },
+    "requested_ticker": {
+      "type": "string"
+    },
+    "state": {
+      "enum": [
+        "current",
+        "aging",
+        "stale"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "state",
+    "last_scored",
+    "age_days"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

removedOutput schema / properties / key_challenges

Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "domain": {
-        "type": [
-          "null",
-          "string"
-        ]
-      },
-      "headline": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "headline"
-    ],
-    "type": "object"
-  },
-  "type": [
-    "null",
-    "array"
-  ]
-}

removedOutput schema / properties / key_strengths

Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "domain": {
-        "type": [
-          "null",
-          "string"
-        ]
-      },
-      "headline": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "headline"
-    ],
-    "type": "object"
-  },
-  "type": [
-    "null",
-    "array"
-  ]
-}

addedOutput schema / properties / message
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / next_step

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "arguments": {
+      "additionalProperties": false,
+      "properties": {
+        "ticker": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ticker"
+      ],
+      "type": [
+        "null",
+        "object"
+      ]
+    },
+    "description": {
+      "type": "string"
+    },
+    "kind": {
+      "enum": [
+        "call_tool",
+        "ask_user",
+        "human_action"
+      ],
+      "type": "string"
+    },
+    "options": {
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "null",
+        "array"
+      ]
+    },
+    "tool": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

addedOutput schema / properties / status

Added value: +{
+  "enum": [
+    "scored",
+    "not_in_surface",
+    "not_covered",
+    "ambiguous",
+    "not_found"
+  ],
+  "type": "string"
+}

changedOutput schema / required

Previous value: -[
-  "ticker",
-  "exchange",
-  "company_name",
-  "sector",
-  "industry",
-  "composite_score",
-  "rating",
-  "domain_scores",
-  "analysis_date",
-  "config_context",
-  "data_source",
-  "scope"
-]New value: +[
+  "status",
+  "ticker",
+  "scope"
+]

Changed2 schema fields changedSep 20, 2026

addedOutput schema / properties / watchlist

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "message": {
+      "type": "string"
+    },
+    "tool": {
+      "type": "string"
+    },
+    "tracked": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "tracked",
+    "tool",
+    "message"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

addedOutput schema / properties / watchlist_offered
```
Added value: +{
+  "type": "boolean"
+}
```

Changed3 schema fields changedSep 5, 2026

addedInput schema / properties / ticker / pattern
```
Added value: +"^[A-Za-z][A-Za-z.\\-]{0,9}$"
```

addedOutput schema / properties / scope

Added value: +{
+  "enum": [
+    "single_ticker"
+  ],
+  "type": "string"
+}

changedOutput schema / required

Previous value: -[
-  "ticker",
-  "exchange",
-  "company_name",
-  "sector",
-  "industry",
-  "composite_score",
-  "rating",
-  "domain_scores",
-  "analysis_date",
-  "config_context",
-  "data_source"
-]New value: +[
+  "ticker",
+  "exchange",
+  "company_name",
+  "sector",
+  "industry",
+  "composite_score",
+  "rating",
+  "domain_scores",
+  "analysis_date",
+  "config_context",
+  "data_source",
+  "scope"
+]

First observedAug 3, 2026

TDQS

Score is being calculated.

All StockLens tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?