Skip to main content
Glama

List tracked products

list_products
Read-onlyIdempotent

The products What's New tracks release notes for, with slugs, categories and platforms. Filter by category and/or a name query.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sortNo"popular" ranks by current audience popularity — outside signals (stars, downloads, players) blended with this site's own readers — and answers "what are the most popular software right now?". Default is the curated catalog order (or search relevance when query is set, which ignores sort).
queryNoFilter by name, e.g. "terminal" or "jetbrains".
categoryNoLimit results to one product category.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
totalYesMatches before the cap.
productsYes
returnedYes
truncatedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedOutput schema / properties / products / items / properties / archived
      Added value: +{
      +  "description": "Whether the upstream repository is archived; absent when unknown.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / language
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / license
      Added value: +{
      +  "description": "SPDX expression as the product's own source states it, e.g. MIT or LicenseRef-proprietary; absent when unknown.",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • changedInput schema / properties / category / enum
      Previous value: -[
      -  "Developer Tools",
      -  "Frameworks & Libraries",
      -  "Languages & Runtimes",
      -  "Games",
      -  "Operating Systems",
      -  "Browsers",
      -  "Communication",
      -  "Media",
      -  "AI",
      -  "Design Tools",
      -  "Productivity",
      -  "Firmware",
      -  "Drivers"
      -]New value: +[
      +  "Developer Tools",
      +  "Frameworks & Libraries",
      +  "Languages & Runtimes",
      +  "Infrastructure & DevOps",
      +  "Databases & Data",
      +  "Security & Privacy",
      +  "Games",
      +  "Gaming Tools",
      +  "Operating Systems",
      +  "System Utilities",
      +  "Browsers",
      +  "Communication",
      +  "Media",
      +  "Creative Tools",
      +  "AI",
      +  "Productivity",
      +  "Lifestyle & Apps",
      +  "Firmware",
      +  "Drivers"
      +]
    • changedOutput schema / properties / products / items / properties / category / enum
      Previous value: -[
      -  "Developer Tools",
      -  "Frameworks & Libraries",
      -  "Languages & Runtimes",
      -  "Games",
      -  "Operating Systems",
      -  "Browsers",
      -  "Communication",
      -  "Media",
      -  "AI",
      -  "Design Tools",
      -  "Productivity",
      -  "Firmware",
      -  "Drivers"
      -]New value: +[
      +  "Developer Tools",
      +  "Frameworks & Libraries",
      +  "Languages & Runtimes",
      +  "Infrastructure & DevOps",
      +  "Databases & Data",
      +  "Security & Privacy",
      +  "Games",
      +  "Gaming Tools",
      +  "Operating Systems",
      +  "System Utilities",
      +  "Browsers",
      +  "Communication",
      +  "Media",
      +  "Creative Tools",
      +  "AI",
      +  "Productivity",
      +  "Lifestyle & Apps",
      +  "Firmware",
      +  "Drivers"
      +]
  3. Changed1 schema field changed
    • addedInput schema / properties / sort
      Added value: +{
      +  "description": "\"popular\" ranks by current audience popularity — outside signals (stars, downloads, players) blended with this site's own readers — and answers \"what are the most popular software right now?\". Default is the curated catalog order (or search relevance when query is set, which ignores sort).",
      +  "enum": [
      +    "curated",
      +    "popular"
      +  ],
      +  "type": "string"
      +}
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "products": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "category": {
      +            "enum": [
      +              "Developer Tools",
      +              "Frameworks & Libraries",
      +              "Languages & Runtimes",
      +              "Games",
      +              "Operating Systems",
      +              "Browsers",
      +              "Communication",
      +              "Media",
      +              "AI",
      +              "Design Tools",
      +              "Productivity",
      +              "Firmware",
      +              "Drivers"
      +            ],
      +            "type": "string"
      +          },
      +          "description": {
      +            "type": "string"
      +          },
      +          "homepage": {
      +            "description": "The vendor's own site.",
      +            "type": "string"
      +          },
      +          "labels": {
      +            "description": "Provenance to keep with any quote, e.g. “Sample data”.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "platforms": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "slug": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "This product's page on What's New.",
      +            "type": "string"
      +          },
      +          "vendor": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "slug",
      +          "name",
      +          "vendor",
      +          "category",
      +          "description",
      +          "url",
      +          "homepage"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "returned": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "total": {
      +      "description": "Matches before the cap.",
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "truncated": {
      +      "const": true,
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "total",
      +    "returned",
      +    "products"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and idempotentHint=true, so the safety profile is covered. The description adds the return shape and filter behavior, but sort semantics and result details are left to the schema and output schema. This is a modest addition, not a contradiction.

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 concise sentences convey scope, returned fields, and filtering behavior with no filler. The most important information is front-loaded.

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

Completeness4/5

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

For a list tool with zero required parameters, fully documented parameters, an output schema, and safety annotations, the description is sufficient for correct invocation. Only minor improvement would be explicit guidance on choosing this over search_releases or whats_new, but that is not essential here.

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 coverage is 100% and the schema gives detailed descriptions for sort and category. The description adds the useful summary that filters can be combined, but it does not materially extend what the schema already provides.

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 verb ('List') and a specific resource ('products What's New tracks release notes for'), and identifies the returned fields ('slugs, categories and platforms'). It is clearly distinct from siblings like search_releases and whats_new, which target release searching and news rather than the product catalog.

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

Usage Guidelines4/5

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

The description frames this as the catalog of tracked products and mentions the available filters ('category and/or a name query'), giving clear context for when to call it. It does not explicitly contrast with search_releases or whats_new, but the resource distinction is implied strongly enough to select correctly.

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.

Resources