Skip to main content
Glama

Similar products

similar_products
Read-onlyIdempotent

List up to 5 products whose descriptions are closest to the given product's description. Similarity is by description embedding only — not quality, popularity, or recency.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "similar_products"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesProduct id from search_products or similar_products

Output Schema

NameRequiredDescriptionDefault
idYes
basisYes
resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / github / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "archived": {
      -        "type": "boolean"
      -      },
      -      "repo": {
      -        "type": "string"
      -      },
      -      "stars": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "stars_as_of": {
      -        "description": "Date of the last daily star count, 'YYYY-MM-DD' (UTC). Counts refresh once a day",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "stars_gained_30d": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Stars gained in the 30 days up to stars_as_of"
      -      },
      -      "stars_gained_7d": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Stars gained in the 7 days up to stars_as_of (negative if lost). Null when the daily history is shorter"
      -      }
      -    },
      -    "required": [
      -      "repo",
      -      "stars",
      -      "archived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "archived": {
      +        "type": "boolean"
      +      },
      +      "pushed_at": {
      +        "description": "Last push to any branch of the repository, ISO 8601 UTC, as GitHub reports it",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "repo": {
      +        "type": "string"
      +      },
      +      "stars": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "stars_as_of": {
      +        "description": "Date of the last daily star count, 'YYYY-MM-DD' (UTC). Counts refresh once a day",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "stars_gained_30d": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Stars gained in the 30 days up to stars_as_of"
      +      },
      +      "stars_gained_7d": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Stars gained in the 7 days up to stars_as_of (negative if lost). Null when the daily history is shorter"
      +      }
      +    },
      +    "required": [
      +      "repo",
      +      "stars",
      +      "archived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / github / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "archived": {
      -        "type": "boolean"
      -      },
      -      "repo": {
      -        "type": "string"
      -      },
      -      "stars": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "repo",
      -      "stars",
      -      "archived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "archived": {
      +        "type": "boolean"
      +      },
      +      "repo": {
      +        "type": "string"
      +      },
      +      "stars": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "stars_as_of": {
      +        "description": "Date of the last daily star count, 'YYYY-MM-DD' (UTC). Counts refresh once a day",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "stars_gained_30d": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Stars gained in the 30 days up to stars_as_of"
      +      },
      +      "stars_gained_7d": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Stars gained in the 7 days up to stars_as_of (negative if lost). Null when the daily history is shorter"
      +      }
      +    },
      +    "required": [
      +      "repo",
      +      "stars",
      +      "archived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed3 schema fields changed
    • addedOutput schema / properties / results / items / properties / forms / description
      Added value: +"Product forms, any of: CLI, Library, Desktop, Mobile, Browser Extension, Self-hosted, MCP Server. More may be added."
    • removedOutput schema / properties / results / items / properties / forms / items / enum
      Removed value: -[
      -  "CLI",
      -  "Library",
      -  "Desktop",
      -  "Mobile",
      -  "Browser Extension",
      -  "Self-hosted"
      -]
    • changedOutput schema / properties / results / items / properties / usage / description
      Previous value: -"Ways to install or connect, matched by repository or domain: MCP servers, Homebrew, npm, PyPI, crates.io. Empty when none is known. No install commands; pick one from the registry."New value: +"Ways to install or connect, matched by repository, domain or MCP Registry namespace: MCP servers, Homebrew, npm, PyPI, crates.io. Empty when none is known. No install commands; pick one from the registry."
  4. Changed6 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +{}
    • changedOutput schema / properties / results / items / additionalProperties
      Previous value: -falseNew value: +{}
    • changedOutput schema / properties / results / items / properties / github / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "archived": {
      -        "type": "boolean"
      -      },
      -      "repo": {
      -        "type": "string"
      -      },
      -      "stars": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "repo",
      -      "stars",
      -      "archived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "archived": {
      +        "type": "boolean"
      +      },
      +      "repo": {
      +        "type": "string"
      +      },
      +      "stars": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "repo",
      +      "stars",
      +      "archived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / results / items / properties / reactions / items / additionalProperties
      Previous value: -falseNew value: +{}
    • changedOutput schema / properties / results / items / properties / usage / items / additionalProperties
      Previous value: -falseNew value: +{}
    • changedOutput schema / properties / results / items / properties / usage / items / properties / package / additionalProperties
      Previous value: -falseNew value: +{}
  5. Changed2 schema fields changed
    • addedOutput schema / properties / results / items / properties / usage
      Added value: +{
      +  "description": "Ways to install or connect, matched by repository or domain: MCP servers, Homebrew, npm, PyPI, crates.io. Empty when none is known. No install commands; pick one from the registry.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "description": "'mcp': MCP server in the official MCP Registry; 'brew'/'cask': Homebrew; 'npm', 'pypi', 'cargo': package",
      +        "enum": [
      +          "mcp",
      +          "brew",
      +          "cask",
      +          "npm",
      +          "pypi",
      +          "cargo"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Name in that registry, e.g. an npm package name or an MCP server name",
      +        "type": "string"
      +      },
      +      "package": {
      +        "additionalProperties": false,
      +        "description": "MCP only: package that runs the server locally, e.g. { type: 'npm', id: '@scope/server' }",
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "id"
      +        ],
      +        "type": "object"
      +      },
      +      "remote": {
      +        "description": "MCP only: remote (streamable HTTP or SSE) URL to connect to",
      +        "type": "string"
      +      },
      +      "scope": {
      +        "description": "'company': matched by domain while the product is a page on its company's site, so it covers the whole company",
      +        "enum": [
      +          "product",
      +          "company"
      +        ],
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Registry page, or for an MCP server its remote URL, website, or repository",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "name",
      +      "url",
      +      "scope"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / results / items / required
      Previous value: -[
      -  "id",
      -  "name",
      -  "summary",
      -  "url",
      -  "domain",
      -  "page_url",
      -  "forms",
      -  "open_source",
      -  "github",
      -  "link_status",
      -  "link_checked_at",
      -  "latest_reaction_at",
      -  "reaction_count",
      -  "reactions"
      -]New value: +[
      +  "id",
      +  "name",
      +  "summary",
      +  "url",
      +  "domain",
      +  "page_url",
      +  "forms",
      +  "open_source",
      +  "github",
      +  "link_status",
      +  "link_checked_at",
      +  "latest_reaction_at",
      +  "reaction_count",
      +  "reactions",
      +  "usage"
      +]
  6. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already establish read-only, idempotent, closed-world, non-destructive behavior, so the bar is lower. The description still adds real value beyond them: a hard cap of 5 results and a precise disclosure of the ranking mechanism (description embedding only), which tells the agent exactly what the ordering means and prevents it from reading the output as a popularity or quality ranking.

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 sentences, zero filler. The selection rule and the result cap come first, and the disambiguating clause about what similarity does not mean follows immediately. Nothing could be removed without losing information.

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?

With a single fully documented parameter, rich annotations, and an output schema handling return values, the description covers everything an agent needs to call this correctly. The only small omission is behavior when fewer than 5 matches exist, which is largely an output concern.

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 itself explains that the id comes from search_products or similar_products. The description adds only that the comparison is run against the product's description rather than its name or metadata, which is a modest clarification. Baseline 3 applies since the schema carries the parameter documentation.

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?

States a concrete verb and resource ("List up to 5 products") plus the exact selection criterion (closest description embeddings), and explicitly rules out quality, popularity, and recency — which is precisely what separates it from trending_products and new_products.

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

Usage Guidelines3/5

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

The negative framing ("not quality, popularity, or recency") implicitly steers an agent away from the trending/new tools, but there is no explicit when-to-use statement and no named alternative or exclusion rule. An agent can infer the intended use case but must do some of the work itself.

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