Skip to main content
Glama

StockLens

by com.stocklens
OverviewDiscussionsAdmin

Discover Stocks

discover_stocks
Read-only

Screen the companies StockLens scores nightly by region, exchange, sector, industry, market-cap band and trading volume, sorted by one of the six StockLens scores or by market cap, volume, popularity or ticker, and return the top or bottom N. Use it for any top N, best, worst, highest, lowest or filtered request across the companies StockLens scores, and never build such a list from get_market_summary or general knowledge; to compare only companies the person names, call get_market_summary for each instead. It has no valuation, price-target or growth filter; say so rather than calling a score sort one. status ranked means the requested order was used. browse_substituted means a score order was asked for and market-cap order with scores hidden was returned, so never describe those rows as ranked by score. locked means no companies are named; relay message verbatim. What the caller can sort and how far it reaches is in access_tier and reach_capped_at. Report only the rows returned. It does not trade and gives no personal recommendations.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNo0-based page of results, 0 to 500. Default 0.
limitNoNumber of matches to return (the N in top/bottom N), 1 to 100. Default 10.
sort_byNoOne of the 6 StockLens scores or a non-score signal to sort by. Default composite_score.
macro_inNoRestrict to these macro regions. Omitted = no restriction.
directionNotop = highest first, bottom = lowest first. Default top.
sector_inNoRestrict to these GICS sectors. Omitted = no restriction.
exchange_inNoRestrict to these exchanges. Omitted = no restriction.
industry_inNoRestrict to these GICS industries. Omitted = no restriction.
search_textNoFree-text company name/ticker search, up to 80 characters.
volume_floorNoMinimum average trading volume. Omitted = no floor.
market_cap_bandNoRestrict to this market-cap band. Omitted = no cap restriction.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
rowsYes
scopeYes
statusYes
messageNo
next_stepNo
as_of_dateNo
access_tierYes
data_sourceYes
hard_lockedYes
rows_returnedYes
scores_lockedYes
total_matchesNo
config_contextYes
effective_sortYes
reach_capped_atNo
sort_substitutedNo
effective_directionYes
quota_remaining_todayNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Number of matches to return (the N in top/bottom N), 1-100. Default 10."New value: +"Number of matches to return (the N in top/bottom N), 1 to 100. Default 10."
    • addedInput schema / properties / limit / maximum
      Added value: +100
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • changedInput schema / properties / page / description
      Previous value: -"0-based page of results, 0-500. Default 0."New value: +"0-based page of results, 0 to 500. Default 0."
    • addedInput schema / properties / page / maximum
      Added value: +500
    • addedInput schema / properties / page / minimum
      Added value: +0
    • addedOutput schema / properties / message
      Added value: +{
+  "type": [
+    "null",
+    "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"
+  ]
+}
    • changedOutput schema / properties / rows / items / properties / macro_code / description
      Previous value: -"Listing geography of the exchange (US, CA, EU, CH, GB, JP, or GLOBAL when unmapped) — the same value macro_in filters on."New value: +"Listing geography of the exchange (US, CA, EU, CH, GB, JP, or GLOBAL when unmapped), the same value macro_in filters on."
    • addedOutput schema / properties / status
      Added value: +{
+  "enum": [
+    "ranked",
+    "browse_substituted",
+    "locked"
+  ],
+  "type": "string"
+}
    • removedOutput schema / properties / upgrade_message
      Removed value: -{
-  "type": [
-    "null",
-    "string"
-  ]
-}
    • changedOutput schema / required
      Previous value: -[
-  "rows",
-  "scores_locked",
-  "hard_locked",
-  "access_tier",
-  "rows_returned",
-  "effective_sort",
-  "effective_direction",
-  "config_context",
-  "data_source",
-  "scope"
-]New value: +[
+  "status",
+  "rows",
+  "scores_locked",
+  "hard_locked",
+  "access_tier",
+  "rows_returned",
+  "effective_sort",
+  "effective_direction",
+  "config_context",
+  "data_source",
+  "scope"
+]
  2. Changed1 schema field changed
    • addedOutput schema / properties / sort_substituted
      Added value: +{
+  "type": "boolean"
+}
  3. Changed2 schema fields changed
    • addedOutput schema / properties / hard_locked
      Added value: +{
+  "type": "boolean"
+}
    • changedOutput schema / required
      Previous value: -[
-  "rows",
-  "scores_locked",
-  "access_tier",
-  "rows_returned",
-  "effective_sort",
-  "effective_direction",
-  "config_context",
-  "data_source",
-  "scope"
-]New value: +[
+  "rows",
+  "scores_locked",
+  "hard_locked",
+  "access_tier",
+  "rows_returned",
+  "effective_sort",
+  "effective_direction",
+  "config_context",
+  "data_source",
+  "scope"
+]
  4. Added

TDQS

Score is being calculated.

All StockLens toolsInspect
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