Skip to main content
Glama

Get collection

get_collection
Read-onlyIdempotent

Quality-ranked tools inside one curated collection. Critical-risk tools are excluded by default (risk_filter); every result carries risk_level and risk_reasons.

Input Schema

NameRequiredDescriptionDefault
slugYes
limitNo
risk_filterNoRisk gate: exclude_critical omits critical risk (default); exclude_high omits high and critical risk; none omits no risk levelsexclude_critical
include_high_riskNoDeprecated alias for risk_filter=none

Output Schema

NameRequiredDescriptionDefault
countYes
resultsYes
collectionYes
total_in_collectionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / results / items / properties / verification
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "commit_sha": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "failing_check": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "id": {
      +              "type": "string"
      +            },
      +            "path": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "required": [
      +            "id",
      +            "path"
      +          ],
      +          "type": "object"
      +        },
      +        "stale": {
      +          "type": "boolean"
      +        },
      +        "status": {
      +          "type": "string"
      +        },
      +        "tier": {
      +          "anyOf": [
      +            {
      +              "enum": [
      +                "runs",
      +                "loads-clean"
      +              ],
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "verified_at": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "status",
      +        "tier",
      +        "commit_sha",
      +        "verified_at",
      +        "stale"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / results / items / required
      Previous value: -[
      -  "name",
      -  "slug",
      -  "tier",
      -  "quality_score",
      -  "composite_score",
      -  "risk_level",
      -  "risk_reasons",
      -  "type",
      -  "category",
      -  "platforms",
      -  "description",
      -  "repo_url",
      -  "profile_url",
      -  "stars",
      -  "is_official",
      -  "last_commit_at"
      -]New value: +[
      +  "name",
      +  "slug",
      +  "tier",
      +  "quality_score",
      +  "composite_score",
      +  "risk_level",
      +  "risk_reasons",
      +  "type",
      +  "category",
      +  "platforms",
      +  "description",
      +  "repo_url",
      +  "profile_url",
      +  "stars",
      +  "is_official",
      +  "last_commit_at",
      +  "verification"
      +]
  2. Changed2 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "collection": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "slug": {
      +          "type": "string"
      +        },
      +        "tagline": {
      +          "type": "string"
      +        },
      +        "title": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "slug",
      +        "title",
      +        "tagline"
      +      ],
      +      "type": "object"
      +    },
      +    "count": {
      +      "type": "number"
      +    },
      +    "results": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "category": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "composite_score": {
      +            "type": "number"
      +          },
      +          "description": {
      +            "type": "string"
      +          },
      +          "is_official": {
      +            "type": "boolean"
      +          },
      +          "last_commit_at": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "platforms": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "profile_url": {
      +            "type": "string"
      +          },
      +          "quality_score": {
      +            "type": "number"
      +          },
      +          "repo_url": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "risk_level": {
      +            "type": "string"
      +          },
      +          "risk_reasons": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "slug": {
      +            "type": "string"
      +          },
      +          "stars": {
      +            "type": "number"
      +          },
      +          "tier": {
      +            "enum": [
      +              "curated",
      +              "promising",
      +              "experimental",
      +              "review_required"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "slug",
      +          "tier",
      +          "quality_score",
      +          "composite_score",
      +          "risk_level",
      +          "risk_reasons",
      +          "type",
      +          "category",
      +          "platforms",
      +          "description",
      +          "repo_url",
      +          "profile_url",
      +          "stars",
      +          "is_official",
      +          "last_commit_at"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "total_in_collection": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "collection",
      +    "total_in_collection",
      +    "count",
      +    "results"
      +  ],
      +  "type": "object"
      +}
  3. Changed3 schema fields changed
    • removedInput schema / properties / include_high_risk / default
      Removed value: -false
    • addedInput schema / properties / include_high_risk / description
      Added value: +"Deprecated alias for risk_filter=none"
    • addedInput schema / properties / risk_filter
      Added value: +{
      +  "default": "exclude_critical",
      +  "description": "Risk gate: exclude_critical omits critical risk (default); exclude_high omits high and critical risk; none omits no risk levels",
      +  "enum": [
      +    "exclude_critical",
      +    "exclude_high",
      +    "none"
      +  ],
      +  "type": "string"
      +}
  4. First observed

TDQS

B3/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, and non-destructive, so the safety profile is covered. The description adds real behavioral value by disclosing that critical-risk tools are filtered out by default (an implicit omission the agent must know about), but its second clause about risk_level/risk_reasons re-states return data already covered by the output schema.

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?

Two tight sentences with no filler, and the default-filter constraint is front-loaded. The opening is a noun fragment rather than an action statement, which costs a little immediate clarity but wastes no words.

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?

Given an output schema that already documents the returned risk fields, the description is close to complete, and it usefully flags the default exclusion of critical-risk tools. The remaining gap is the undocumented slug and limit parameters plus the absence of any routing guidance against the sibling collection/search tools. Wait -- I gave parameter_semantics 3 and usage 2; to keep independence, this dimension focuses on overall sufficiency, which is still short on slug/limit semantics and sibling routing, so 3.

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 50%: risk_filter and include_high_risk carry inline descriptions (including the deprecation of include_high_risk), while slug and limit are undocumented. The description reinforces the risk_filter gate semantics ('critical-risk tools are excluded by default'), which adds marginal value, but contributes nothing about slug enumeration or the limit cap of 25. Baseline 3 is appropriate.

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

Purpose3/5

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

The description conveys the resource ('tools inside one curated collection') and a quality ranking, so the agent knows roughly what comes back. But it never states the operative verb or that the required 'slug' selects a single named collection, so the action is inferred from the tool name rather than described. It is distinguishable from list_collections and search_skills only weakly.

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

Usage Guidelines2/5

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

No guidance on when to call this instead of the very close siblings list_collections, search_skills, or compare_tools. The only conditional information offered is the default risk filtering behavior, which is a parameter effect rather than a use-case rule.

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.