Skip to main content
Glama

Resolve

resolve
Read-onlyIdempotent

Start here to find documentation for a domain or development task. Returns specific page URLs with publisher excerpts, matching evidence, owner-stated terms, freshness and alternatives. Task relevance ranks ahead of ownership verification. Weak matches are fallback candidates: refine the query or search elsewhere. Use max_age to mark stale data, refresh to validate the source live, and detail=full for owner metadata. Reads need no key.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of documentation sources.
queryYesA domain or development task, e.g. "modelcontextprotocol authorization".
detailNoCompact consumer fields by default; full adds owner profile, claims and listing metadata.compact
max_ageNoMaximum acceptable age of source health in seconds; stale data is marked, not hidden.
refreshNoValidate the selected source live (bounded and rate limited); does not change the directory listing.
categoryNoFilter by inferred topic ID from list_categories. Topics describe publisher metadata, not capabilities or correctness.
capabilityNoFilter to sites explicitly publishing an MCP endpoint link. Publisher declaration alone does not prove availability.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changed
    • addedInput schema / properties / capability
      Added value: +{
      +  "description": "Filter to sites explicitly publishing an MCP endpoint link. Publisher declaration alone does not prove availability.",
      +  "enum": [
      +    "mcp"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / category
      Added value: +{
      +  "description": "Filter by inferred topic ID from list_categories. Topics describe publisher metadata, not capabilities or correctness.",
      +  "enum": [
      +    "ai-ml",
      +    "developer-tools",
      +    "infrastructure",
      +    "data-analytics",
      +    "cybersecurity",
      +    "finance-payments",
      +    "ecommerce",
      +    "productivity",
      +    "marketing",
      +    "education",
      +    "healthcare",
      +    "media",
      +    "design",
      +    "gaming",
      +    "travel",
      +    "community",
      +    "legal",
      +    "recruiting-careers",
      +    "industrial-manufacturing",
      +    "real-estate",
      +    "arts-culture",
      +    "sports-fitness",
      +    "food-dining",
      +    "automotive",
      +    "government-public-services",
      +    "science-research"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / detail
      Added value: +{
      +  "default": "compact",
      +  "description": "Compact consumer fields by default; full adds owner profile, claims and listing metadata.",
      +  "enum": [
      +    "compact",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "default": 3,
      +  "description": "Maximum number of documentation sources.",
      +  "maximum": 5,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / max_age
      Added value: +{
      +  "default": 86400,
      +  "description": "Maximum acceptable age of source health in seconds; stale data is marked, not hidden.",
      +  "maximum": 2592000,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / query / description
      Previous value: -"A domain or a topic."New value: +"A domain or development task, e.g. \"modelcontextprotocol authorization\"."
    • addedInput schema / properties / query / maxLength
      Added value: +200
    • addedInput schema / properties / query / minLength
      Added value: +1
    • addedInput schema / properties / query / pattern
      Added value: +"\\S"
    • addedInput schema / properties / refresh
      Added value: +{
      +  "default": false,
      +  "description": "Validate the selected source live (bounded and rate limited); does not change the directory listing.",
      +  "type": "boolean"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "alternatives": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "authority": {
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "domain": {
      +                "type": "string"
      +              },
      +              "llms_txt": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "match_score": {
      +                "type": "number"
      +              },
      +              "tier": {
      +                "enum": [
      +                  "featured",
      +                  "listed",
      +                  "unlisted",
      +                  "rejected",
      +                  null
      +                ],
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "title": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "verified": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "domain",
      +              "title",
      +              "authority",
      +              "tier",
      +              "verified",
      +              "llms_txt"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "best": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "agent_terms": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "attribution": {
      +                      "enum": [
      +                        "required",
      +                        "appreciated",
      +                        "none"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "attribution_text": {
      +                      "maxLength": 200,
      +                      "type": "string"
      +                    },
      +                    "automated_access": {
      +                      "enum": [
      +                        "welcome",
      +                        "limited",
      +                        "ask",
      +                        "not_allowed"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "notes": {
      +                      "maxLength": 500,
      +                      "type": "string"
      +                    },
      +                    "pricing": {
      +                      "enum": [
      +                        "free",
      +                        "freemium",
      +                        "paid"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "pricing_url": {
      +                      "type": "string"
      +                    },
      +                    "rate_limit": {
      +                      "maxLength": 100,
      +                      "type": "string"
      +                    },
      +                    "terms_url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "authority": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "badge": {
      +              "type": "string"
      +            },
      +            "capabilities": {
      +              "description": "Publisher-declared capabilities. An MCP declaration does not prove availability or protocol compatibility.",
      +              "items": {
      +                "enum": [
      +                  "mcp"
      +                ],
      +                "type": "string"
      +              },
      +              "type": "array",
      +              "uniqueItems": true
      +            },
      +            "capability_evidence": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "id": {
      +                    "const": "mcp"
      +                  },
      +                  "source_url": {
      +                    "type": "string"
      +                  },
      +                  "status": {
      +                    "const": "publisher_declared"
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "url",
      +                  "source_url",
      +                  "status"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "categories": {
      +              "description": "Inferred topic IDs from publisher metadata; empty means unclassified.",
      +              "items": {
      +                "enum": [
      +                  "ai-ml",
      +                  "developer-tools",
      +                  "infrastructure",
      +                  "data-analytics",
      +                  "cybersecurity",
      +                  "finance-payments",
      +                  "ecommerce",
      +                  "productivity",
      +                  "marketing",
      +                  "education",
      +                  "healthcare",
      +                  "media",
      +                  "design",
      +                  "gaming",
      +                  "travel",
      +                  "community",
      +                  "legal",
      +                  "recruiting-careers",
      +                  "industrial-manufacturing",
      +                  "real-estate",
      +                  "arts-culture",
      +                  "sports-fitness",
      +                  "food-dining",
      +                  "automotive",
      +                  "government-public-services",
      +                  "science-research"
      +                ],
      +                "type": "string"
      +              },
      +              "maxItems": 5,
      +              "type": "array",
      +              "uniqueItems": true
      +            },
      +            "categorized_at": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "category_evidence": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "confidence": {
      +                    "description": "Deterministic rule strength, not a calibrated probability.",
      +                    "maximum": 1,
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  "evidence": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "id": {
      +                    "enum": [
      +                      "ai-ml",
      +                      "developer-tools",
      +                      "infrastructure",
      +                      "data-analytics",
      +                      "cybersecurity",
      +                      "finance-payments",
      +                      "ecommerce",
      +                      "productivity",
      +                      "marketing",
      +                      "education",
      +                      "healthcare",
      +                      "media",
      +                      "design",
      +                      "gaming",
      +                      "travel",
      +                      "community",
      +                      "legal",
      +                      "recruiting-careers",
      +                      "industrial-manufacturing",
      +                      "real-estate",
      +                      "arts-culture",
      +                      "sports-fitness",
      +                      "food-dining",
      +                      "automotive",
      +                      "government-public-services",
      +                      "science-research"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "source": {
      +                    "const": "publisher_metadata"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "confidence",
      +                  "evidence",
      +                  "source"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "category_version": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "claim": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "benefits": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "docs": {
      +                  "type": "string"
      +                },
      +                "hint": {
      +                  "type": "string"
      +                },
      +                "mcp": {
      +                  "type": "string"
      +                },
      +                "verification": {
      +                  "type": "string"
      +                },
      +                "verify": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "hint",
      +                "verification",
      +                "verify",
      +                "docs",
      +                "mcp",
      +                "benefits"
      +              ],
      +              "type": "object"
      +            },
      +            "contact": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "country": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "description": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "domain": {
      +              "type": "string"
      +            },
      +            "evidence": {
      +              "items": {
      +                "additionalProperties": true,
      +                "properties": {
      +                  "excerpt": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "source_url": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "title": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "url"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "first_seen": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "last_checked": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "links": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "llms_full_txt": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "llms_txt": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "match_score": {
      +              "type": "number"
      +            },
      +            "nested_llms_txt": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "rank": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "registered_at": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "sections": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "status": {
      +              "enum": [
      +                "pending",
      +                "valid",
      +                "invalid",
      +                "unreachable"
      +              ],
      +              "type": "string"
      +            },
      +            "summary": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "tags": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "tier": {
      +              "enum": [
      +                "featured",
      +                "listed",
      +                "unlisted",
      +                "rejected",
      +                null
      +              ],
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "title": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "verified": {
      +              "type": "boolean"
      +            },
      +            "verified_at": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "why": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "required": [
      +            "domain",
      +            "status",
      +            "tier",
      +            "authority",
      +            "verified",
      +            "title",
      +            "summary",
      +            "llms_txt",
      +            "llms_full_txt",
      +            "last_checked",
      +            "agent_terms",
      +            "categories",
      +            "capabilities"
      +          ],
      +          "type": "object"
      +        },
      +        "health": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "authority": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "checked_minutes_ago": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "content_hash": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "http_status": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "last_checked": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "last_valid": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "live_checked": {
      +              "type": "boolean"
      +            },
      +            "max_age_seconds": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "ok": {
      +              "type": "boolean"
      +            },
      +            "stale": {
      +              "type": "boolean"
      +            },
      +            "status": {
      +              "enum": [
      +                "pending",
      +                "valid",
      +                "invalid",
      +                "unreachable"
      +              ],
      +              "type": "string"
      +            },
      +            "tier": {
      +              "enum": [
      +                "featured",
      +                "listed",
      +                "unlisted",
      +                "rejected",
      +                null
      +              ],
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "ok",
      +            "status",
      +            "tier",
      +            "authority",
      +            "last_checked",
      +            "checked_minutes_ago",
      +            "stale",
      +            "max_age_seconds",
      +            "live_checked",
      +            "http_status",
      +            "last_valid",
      +            "content_hash"
      +          ],
      +          "type": "object"
      +        },
      +        "match": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "reason": {
      +              "type": "string"
      +            },
      +            "strength": {
      +              "enum": [
      +                "domain",
      +                "strong",
      +                "weak"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "strength",
      +            "reason"
      +          ],
      +          "type": "object"
      +        },
      +        "mode": {
      +          "enum": [
      +            "domain",
      +            "topic"
      +          ],
      +          "type": "string"
      +        },
      +        "provenance": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "excerpts": {
      +              "const": "publisher_link_metadata"
      +            },
      +            "health": {
      +              "enum": [
      +                "live_check",
      +                "stored_crawl"
      +              ],
      +              "type": "string"
      +            },
      +            "selection": {
      +              "const": "directory"
      +            },
      +            "terms": {
      +              "enum": [
      +                "owner_stated",
      +                "unknown"
      +              ],
      +              "type": "string"
      +            },
      +            "verification": {
      +              "const": "domain_ownership"
      +            }
      +          },
      +          "required": [
      +            "selection",
      +            "verification",
      +            "terms",
      +            "excerpts",
      +            "health"
      +          ],
      +          "type": "object"
      +        },
      +        "query": {
      +          "type": "string"
      +        },
      +        "read": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "llms_full_txt": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "llms_txt": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "nested_llms_txt": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "required": [
      +            "llms_txt",
      +            "llms_full_txt",
      +            "nested_llms_txt"
      +          ],
      +          "type": "object"
      +        },
      +        "sources": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "checked_at": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "content_hash": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "excerpt": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "match_score": {
      +                "maximum": 1,
      +                "minimum": 0,
      +                "type": "number"
      +              },
      +              "section": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "source_url": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "url",
      +              "title",
      +              "excerpt",
      +              "section",
      +              "source_url",
      +              "match_score",
      +              "checked_at",
      +              "content_hash"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "terms": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "attribution": {
      +                  "enum": [
      +                    "required",
      +                    "appreciated",
      +                    "none"
      +                  ],
      +                  "type": "string"
      +                },
      +                "attribution_text": {
      +                  "maxLength": 200,
      +                  "type": "string"
      +                },
      +                "automated_access": {
      +                  "enum": [
      +                    "welcome",
      +                    "limited",
      +                    "ask",
      +                    "not_allowed"
      +                  ],
      +                  "type": "string"
      +                },
      +                "notes": {
      +                  "maxLength": 500,
      +                  "type": "string"
      +                },
      +                "pricing": {
      +                  "enum": [
      +                    "free",
      +                    "freemium",
      +                    "paid"
      +                  ],
      +                  "type": "string"
      +                },
      +                "pricing_url": {
      +                  "type": "string"
      +                },
      +                "rate_limit": {
      +                  "maxLength": 100,
      +                  "type": "string"
      +                },
      +                "terms_url": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "watch": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "query",
      +        "mode",
      +        "best",
      +        "read",
      +        "terms",
      +        "health",
      +        "sources",
      +        "match",
      +        "provenance",
      +        "alternatives",
      +        "watch"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "best": {
      +          "type": "null"
      +        },
      +        "error": {
      +          "type": "string"
      +        },
      +        "match": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "reason": {
      +              "type": "string"
      +            },
      +            "strength": {
      +              "enum": [
      +                "domain",
      +                "strong",
      +                "weak"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "strength",
      +            "reason"
      +          ],
      +          "type": "object"
      +        },
      +        "mode": {
      +          "enum": [
      +            "domain",
      +            "topic"
      +          ],
      +          "type": "string"
      +        },
      +        "query": {
      +          "type": "string"
      +        },
      +        "sources": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "checked_at": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "content_hash": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "excerpt": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "match_score": {
      +                "maximum": 1,
      +                "minimum": 0,
      +                "type": "number"
      +              },
      +              "section": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "source_url": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "url",
      +              "title",
      +              "excerpt",
      +              "section",
      +              "source_url",
      +              "match_score",
      +              "checked_at",
      +              "content_hash"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "suggest": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "browse": {
      +              "type": "string"
      +            },
      +            "check": {
      +              "type": "string"
      +            },
      +            "hint": {
      +              "type": "string"
      +            },
      +            "register": {
      +              "type": "string"
      +            },
      +            "search": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hint"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "query",
      +        "mode",
      +        "best",
      +        "suggest"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": true,
      +      "properties": {
      +        "detail": {
      +          "type": "string"
      +        },
      +        "domain": {
      +          "type": "string"
      +        },
      +        "error": {
      +          "type": "string"
      +        },
      +        "hint": {
      +          "type": "string"
      +        },
      +        "retry_after_seconds": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  2. Added

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, openWorld), yet the description adds real value: ranking policy ("task relevance ranks ahead of ownership verification"), fallback semantics for weak matches, and auth expectations ("Reads need no key"). It also notes that refresh is bounded/rate limited and non-mutating for the directory, though that last point duplicates the 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?

About six tight sentences, front-loaded with the entry-point statement, followed by return shape, ranking policy, fallback guidance, parameter hints, and auth. The parameter sentence at the end is the weakest link because it largely restates the schema.

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 7 parameters (1 required), full schema coverage, and an output schema, the description supplies the things structure cannot: entry-point framing, ranking behavior, failure handling, and no-key access. Little is missing for an agent to call it correctly, though sibling routing remains unspecified.

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 baseline is 3. The description's guidance (max_age for stale data, refresh to validate live, detail=full for owner metadata) frames parameters in workflow terms, but each fact is already stated in the corresponding schema descriptions, so the marginal value is limited.

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

Purpose4/5

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

The opening "Start here to find documentation for a domain or development task" gives a specific verb (find) and resource (documentation), and it lists the return payload (page URLs, excerpts, evidence, terms, freshness, alternatives). It signals an entry-point role but never names a sibling such as lookup_domain or search_llms_registry, so differentiation is left implicit.

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?

"Start here" establishes the intended first-call context, and "Weak matches are fallback candidates: refine the query or search elsewhere" gives an explicit failure-path instruction. It stops short of naming which sibling to use instead, so the alternative is generic rather than concrete.

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.