Skip to main content
Glama
longbridge

longbridge

Official
by longbridge
OverviewSchemaSourceRelated ServersDiscussions(1)Admin
Rust
Hybrid

Valuation

valuation
Read-onlyIdempotent

Retrieve a valuation overview with peer comparison for US or HK stocks. For US symbols, includes a summary and additional metrics tailored to the account's region.

Instructions

Get valuation overview with peer comparison. US accounts querying a .US symbol get a US-specific variant (ai_summary plus a metrics.pe object with different sub-fields). The region is detected from the account automatically.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
_jqNoOptional jq filter (jaq syntax) applied to this tool's JSON response before it is returned; it never changes the upstream request. One output is returned as-is, several as a JSON array, none as []. Module imports and the `env`/`debug`/`stderr` builtins are unavailable. Example: .data | map({symbol}). Omit for the full response.
symbolYesSecurity symbol, e.g. "700.HK". Use the canonical form — a padded code like "00700.HK" returns an empty record, not an error.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.12.0
    • addedInput schema / properties / _jq / description
      Added value: +"Optional jq filter (jaq syntax) applied to this tool's JSON response before it is returned; it never changes the upstream request. One output is returned as-is, several as a JSON array, none as []. Module imports and the `env`/`debug`/`stderr` builtins are unavailable. Example: .data | map({symbol}). Omit for the full response."
    • changedInput schema / properties / symbol / description
      Previous value: -"Security symbol, e.g. \"700.HK\""New value: +"Security symbol, e.g. \"700.HK\". Use the canonical form — a padded code like \"00700.HK\" returns an empty record, not an error."
  2. Changed2 schema fields changedv0.10.6
    • addedInput schema / properties / _jq
      Added value: +{
+  "type": "string"
+}
    • changedOutput schema / (root)
      Previous value: -{
-  "$defs": {
-    "ValuationMetric": {
-      "properties": {
-        "5yr_avg": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "current": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "desc": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "industry_avg": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "industry_median": {
-          "format": "double",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "metric": {
-          "format": "double",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "percentile": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "ValuationMetrics": {
-      "properties": {
-        "dividend_yield": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/ValuationMetric"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "pb": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/ValuationMetric"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "pe": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/ValuationMetric"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "ps": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/ValuationMetric"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    }
-  },
-  "properties": {
-    "ai_summary": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "ccy_symbol": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "date": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "indicator": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "metrics": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ValuationMetrics"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "range": {
-      "format": "int32",
-      "type": [
-        "integer",
-        "null"
-      ]
-    }
-  },
-  "type": "object"
-}New value: +null
  3. Changed8 schema fields changedv0.8.4
    • addedOutput schema / $defs / ValuationMetric / properties / desc
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / $defs / ValuationMetric / properties / industry_median
      Added value: +{
+  "format": "double",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedOutput schema / $defs / ValuationMetric / properties / metric
      Added value: +{
+  "format": "double",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedOutput schema / properties / ai_summary
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / ccy_symbol
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / date
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / indicator
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / range
      Added value: +{
+  "format": "int32",
+  "type": [
+    "integer",
+    "null"
+  ]
+}
  4. Changed1 schema field changedv0.7.1
    • removedInput schema / title
      Removed value: -"SymbolParam"
  5. Changed14 schema fields changedv0.6.0
    • removedOutput schema / $defs / ValuationMetric / description
      Removed value: -"A single valuation indicator block in `valuation`.\n\nSubset of documented fields; upstream may return more."
    • removedOutput schema / $defs / ValuationMetric / properties / 5yr_avg / description
      Removed value: -"5-year average. (camelCase `5yr_avg` per description.)"
    • removedOutput schema / $defs / ValuationMetric / properties / current / description
      Removed value: -"Current value."
    • removedOutput schema / $defs / ValuationMetric / properties / industry_avg / description
      Removed value: -"Industry average."
    • removedOutput schema / $defs / ValuationMetric / properties / percentile / description
      Removed value: -"Historical percentile."
    • removedOutput schema / $defs / ValuationMetrics / description
      Removed value: -"`metrics` block of `valuation`. Each indicator carries the same shape.\n\nSubset of documented fields; upstream may return more."
    • removedOutput schema / $defs / ValuationMetrics / properties / dividend_yield / description
      Removed value: -"Dividend-yield block."
    • removedOutput schema / $defs / ValuationMetrics / properties / pb / description
      Removed value: -"Price-to-book block."
    • removedOutput schema / $defs / ValuationMetrics / properties / pe / description
      Removed value: -"Price-to-earnings block."
    • removedOutput schema / $defs / ValuationMetrics / properties / ps / description
      Removed value: -"Price-to-sales block."
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / description
      Removed value: -"Returned by `valuation`. The valuation overview groups per-metric blocks\nunder `metrics`.\n\nSubset of documented fields; upstream may return more."
    • removedOutput schema / properties / metrics / description
      Removed value: -"Valuation metric blocks keyed by indicator."
    • removedOutput schema / title
      Removed value: -"ValuationResponse"
  6. Changed1 schema field changedv0.5.6
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$defs": {
+    "ValuationMetric": {
+      "description": "A single valuation indicator block in `valuation`.\n\nSubset of documented fields; upstream may return more.",
+      "properties": {
+        "5yr_avg": {
+          "description": "5-year average. (camelCase `5yr_avg` per description.)",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "current": {
+          "description": "Current value.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "industry_avg": {
+          "description": "Industry average.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "percentile": {
+          "description": "Historical percentile.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "ValuationMetrics": {
+      "description": "`metrics` block of `valuation`. Each indicator carries the same shape.\n\nSubset of documented fields; upstream may return more.",
+      "properties": {
+        "dividend_yield": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ValuationMetric"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Dividend-yield block."
+        },
+        "pb": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ValuationMetric"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Price-to-book block."
+        },
+        "pe": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ValuationMetric"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Price-to-earnings block."
+        },
+        "ps": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ValuationMetric"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Price-to-sales block."
+        }
+      },
+      "type": "object"
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "Returned by `valuation`. The valuation overview groups per-metric blocks\nunder `metrics`.\n\nSubset of documented fields; upstream may return more.",
+  "properties": {
+    "metrics": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ValuationMetrics"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Valuation metric blocks keyed by indicator."
+    }
+  },
+  "title": "ValuationResponse",
+  "type": "object"
+}
  7. Addedv0.4.5
  8. Removedv0.4.0
  9. Addedv0.3.2
  10. Removedv0.3.1
  11. First observedv0.1.12

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already mark it read-only/idempotent. The description adds value by disclosing the region-specific response variant (ai_summary, metrics.pe) and automatic region detection, which are not present in the schema or annotations.

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

Conciseness5/5

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

Two short sentences, front-loaded with the core action and then the exception. No filler or redundancy.

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

Completeness3/5

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

For a read-only overview with no output schema, it explains the region variant but leaves the return format and the meaning of 'peer comparison' unspecified. Adequate, but an agent may need to infer output contents.

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

Parameters3/5

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

Schema has 100% coverage for both parameters (symbol and _jq), so it already carries parameter meaning. The description adds context about region-dependent output but does not add syntax or format details beyond what the schema provides.

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

Purpose4/5

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

Clearly states it retrieves a valuation overview with peer comparison, and notes a US-specific variant. However, it does not distinguish from sibling tools like valuation_comparison or valuation_history, so an agent could confuse it with those.

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

Usage Guidelines2/5

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

No guidance on when to choose valuation over siblings such as valuation_comparison or valuation_history. The description only describes behavior, not selection criteria or exclusions.

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

Deploy Server

Other Tools