Skip to main content
Glama

OneQAZ Trading Intelligence

Group Context

get_group_context
Read-onlyIdempotent

Use when the question is about a sector, theme, ETF basket or index basket — its structure state and its members. Returns headline claims, the group's regime state per interval, its market, groups that co-move with it, member symbols with their latest signal bias, symbols the basket leads, and gaps. Not for a single stock (use get_symbol_context) or a whole market (use get_market_context). Provides regime, signal-score and linkage context with sample sizes and measured hit rates; every link carries its evidence and every empty section is listed in gaps. Not a real-time quote, fundamentals, or full-text news source. Output nature: Self-contained context for one entity: observed state, tracked links with their evidence and sample sizes, and explicit gaps. Not investment advice.

Input Schema

NameRequiredDescriptionDefault
groupYesOneQAZ structure group id (kr_semiconductor, technology, broad_index), a sector word (반도체, energy) or an ETF ticker that belongs to a group (QQQ).
limitNoMax links per section (default 8, max 50; members default 10).
questionNoOptional. The user's original question, used only for service improvement analytics. Does not change the response. Do not include personal information.
market_idNoOptional. crypto / kr_stock / us_stock (aliases coin/kr/us). Group ids repeat across markets.

Output Schema

NameRequiredDescriptionDefault
gapsNo
metaNo
newsNo
selfNo
peersNo
entityNo
headlineNo
upstreamNo
timestampYesRFC3339 UTC, server build time
disclaimerYesCanonical compliance disclaimer (always present)
downstreamNo
request_idYes32-hex per-response correlation id
resolutionNo
data_classificationNo
is_investment_adviceNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedOutput schema / properties / downstream / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "tagged_with",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by",
      +            "market_wide_context"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / news / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "tagged_with",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by",
      +            "market_wide_context"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / peers / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "tagged_with",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by",
      +            "market_wide_context"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / upstream / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "tagged_with",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by",
      +            "market_wide_context"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / question / description
      Previous value: -"Optional. The user's original question, used only for service improvement analytics. Does not change the response."New value: +"Optional. The user's original question, used only for service improvement analytics. Does not change the response. Do not include personal information."
  3. Changed4 schema fields changed
    • changedOutput schema / properties / downstream / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / news / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / peers / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / upstream / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "evidence": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "as_of": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "kind": {
      -              "enum": [
      -                "statistical",
      -                "definitional",
      -                "tag",
      -                "hypothesis"
      -              ],
      -              "type": "string"
      -            },
      -            "metric": {
      -              "type": "string"
      -            },
      -            "n": {
      -              "anyOf": [
      -                {
      -                  "type": "integer"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "source_table": {
      -              "type": "string"
      -            },
      -            "validation": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": true,
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            },
      -            "value": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "default": null
      -            }
      -          },
      -          "required": [
      -            "kind",
      -            "metric",
      -            "source_table"
      -          ],
      -          "type": "object"
      -        },
      -        "relation": {
      -          "description": "Reads '<entity> <relation> <target>'",
      -          "enum": [
      -            "leads",
      -            "lags",
      -            "co_moves",
      -            "member_of",
      -            "has_member",
      -            "mentioned_in",
      -            "affects",
      -            "affected_by"
      -          ],
      -          "type": "string"
      -        },
      -        "scope": {
      -          "default": "direct",
      -          "enum": [
      -            "direct",
      -            "group",
      -            "market_wide"
      -          ],
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "target_observation": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        }
      -      },
      -      "required": [
      -        "target",
      -        "relation",
      -        "evidence"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "evidence": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "as_of": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "kind": {
      +              "enum": [
      +                "statistical",
      +                "definitional",
      +                "tag",
      +                "hypothesis"
      +              ],
      +              "type": "string"
      +            },
      +            "metric": {
      +              "type": "string"
      +            },
      +            "n": {
      +              "anyOf": [
      +                {
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "source_table": {
      +              "type": "string"
      +            },
      +            "validation": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            },
      +            "value": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "default": null
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "metric",
      +            "source_table"
      +          ],
      +          "type": "object"
      +        },
      +        "relation": {
      +          "description": "Reads '<entity> <relation> <target>'",
      +          "enum": [
      +            "leads",
      +            "lags",
      +            "co_moves",
      +            "member_of",
      +            "has_member",
      +            "mentioned_in",
      +            "tagged_with",
      +            "affects",
      +            "affected_by"
      +          ],
      +          "type": "string"
      +        },
      +        "scope": {
      +          "default": "direct",
      +          "enum": [
      +            "direct",
      +            "group",
      +            "market_wide"
      +          ],
      +          "type": "string"
      +        },
      +        "target": {
      +          "additionalProperties": true,
      +          "type": "object"
      +        },
      +        "target_observation": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        }
      +      },
      +      "required": [
      +        "target",
      +        "relation",
      +        "evidence"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  4. Changed1 schema field changed
    • addedInput schema / properties / question
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Optional. The user's original question, used only for service improvement analytics. Does not change the response."
      +}
  5. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already establish read-only and idempotent behavior, but the description adds substantial context beyond them: it lists returned sections, sample sizes, measured hit rates, evidence attached to every link, gaps for empty sections, and exclusions such as not a real-time quote, fundamentals, or full-text news source.

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

Conciseness4/5

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

The description is front-loaded with usage guidance and is generally efficient. It has some repetition between 'Returns...', 'Provides...', and 'Output nature...', but every sentence still contributes to scope or expectations.

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?

Given the rich schema, annotations, and existing output schema, the description is complete enough for correct invocation: it covers purpose, scope, alternatives, exclusions, and the nature of the response without needing to explain return schema fields.

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 description coverage is 100%, so the schema already documents group, limit, question, and market_id. The description provides examples of acceptable group concepts but adds no syntax or constraints beyond what the schema provides, making the baseline 3 appropriate.

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 states a specific resource and scope: sector, theme, ETF basket, or index basket structure state and members. It explicitly distinguishes itself from get_symbol_context for a single stock and get_market_context for a whole market, so an agent can select it without opening sibling schemas.

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

Usage Guidelines5/5

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

It gives explicit when-to-use guidance ('Use when the question is about a sector, theme, ETF basket or index basket') and clear when-not-to-use alternatives ('Not for a single stock (use get_symbol_context) or a whole market (use get_market_context)').

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.