mytopfive.app

search_public_lists

Search public Top Five lists by keyword and return each match with its creator, description and a link. Replays the same query the Discover screen runs, so the results are exactly the lists that screen would show for the same words. Matching is a case-insensitive substring over list title and description — not semantic — so "sushi" finds "Sushi in NYC" but not "Best Japanese food". Public lists only — the query filters on is_public and the call carries no session, so a private list is not reachable through this tool even for the person viewing the page. Results come back under "rows", newest first, each with the list's title, creator, description where it has one, and "url" — the path to that list's page on this site. An empty rows array means nothing matched.

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords to match against list titles and descriptions, e.g. \"sushi\"."
    },
    "max_results": {
      "type": "integer",
      "description": "Cap on returned lists (default 10; the Discover screen itself uses 20).",
      "default": 10
    }
  },
  "required": [
    "query"
  ]
}