Skip to main content
Glama

Search browser games

search_games
Read-onlyIdempotent

Searches the free browser games listed on Foundplay, made by independent creators, many of them with AI tools. Matches the query against each game's title, one-line description and genres. Returns catalog device and multiplayer facts, counted outbound clicks, upvotes, creator credit and Foundplay page links. Read-only. Defaults to most played; best uses the website's quality ranking and returns its method and limits, not a hands-on review. The optional aiMade filter requires recorded AI-creation provenance. The query may be in Spanish, Portuguese, German, French, Italian or Indonesian; with lang, pitches and page links are in that language where Foundplay has a translation.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

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

Input Schema

NameRequiredDescriptionDefault
langNoThe language the person is asking in: es (Spanish), pt (Portuguese), de (German), fr (French), it (Italian) or id (Indonesian). The query is read in that language, and each pitch and page link is in it where Foundplay has a translation, else English. en keeps the query English. Omitted, a query plainly in one of the six is read in it.
sortNopopular (all-time counted clicks, the default), trending (last 48 hours), new (newest Foundplay listings, not original release dates), or best (the website's quality ranking of eligible originals).
genreNoOnly games in this genre.
limitNoHow many games to return. Default 8.
phoneNotrue for catalog phone support, such as touch controls. Not a physical-device test or a guarantee for every iPhone, Android device or browser.
queryNoWords required in the title, description or genre, such as 'zombie shooter' or 'cozy farm'. Use phone and aiMade flags for those constraints instead of adding them as query words. Leave empty or omit for broad discovery with filters.
aiMadeNotrue requires recorded evidence of AI-assisted creation, using the website's AI-made list rules. False or omitted does not filter by AI use; missing evidence is unknown.
multiplayerNotrue for catalog multiplayer support, online or on one screen. Does not guarantee online play or a particular player count.

Output Schema

NameRequiredDescriptionDefault
gamesYes
listsYes
totalYesHow many games matched in all.
rankingNoPresent for best order, including when no eligible game matches.
languageNoPresent when the query was read in Spanish, Portuguese, German, French, Italian or Indonesian, including when no games match.
apiSearchNoPublic JSON search self-link retaining text, sort, limit, genre, phone, multiplayer, AI-made filters and the language. Public assistant eligibility applies; no owner authorization is included.
browseAllYesBroader website Browse destination preserving only its supported filters. See browseAllMeaning; it is not the same eligible result set.
phoneFilterNoPresent when phone is true, including empty results. Describes recorded support and its limits.
aiMadeFilterNoPresent when aiMade is true, including when no games match.
listsMeaningYesRelated lists match by title; their contents are not restricted by the game's requested filters.
playsMeaningYesHow the public play count is measured and what it does not establish.
browseAllMeaningNoWhich request choices the broader website Browse link preserves and which it does not.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedInput schema / properties / lang
      Added value: +{
      +  "description": "The language the person is asking in: es (Spanish), pt (Portuguese), de (German), fr (French), it (Italian) or id (Indonesian). The query is read in that language, and each pitch and page link is in it where Foundplay has a translation, else English. en keeps the query English. Omitted, a query plainly in one of the six is read in it.",
      +  "enum": [
      +    "en",
      +    "es",
      +    "pt",
      +    "de",
      +    "fr",
      +    "it",
      +    "id"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / apiSearch / description
      Previous value: -"Public JSON search self-link retaining text, sort, limit, genre, phone, multiplayer and AI-made filters. Public assistant eligibility applies; no owner authorization is included."New value: +"Public JSON search self-link retaining text, sort, limit, genre, phone, multiplayer, AI-made filters and the language. Public assistant eligibility applies; no owner authorization is included."
    • addedOutput schema / properties / games / items / properties / pageLanguage
      Added value: +{
      +  "description": "Present when the search was read in another language: the language of the linked Foundplay page. Not the language of the game itself.",
      +  "enum": [
      +    "en",
      +    "es",
      +    "pt",
      +    "de",
      +    "fr",
      +    "it",
      +    "id"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / games / items / properties / pitchLanguage
      Added value: +{
      +  "description": "Present when the search was read in another language: the language the pitch is in. en when Foundplay has no translation of the current pitch.",
      +  "enum": [
      +    "en",
      +    "es",
      +    "pt",
      +    "de",
      +    "fr",
      +    "it",
      +    "id"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / language
      Added value: +{
      +  "description": "Present when the query was read in Spanish, Portuguese, German, French, Italian or Indonesian, including when no games match.",
      +  "properties": {
      +    "applied": {
      +      "enum": [
      +        "es",
      +        "pt",
      +        "de",
      +        "fr",
      +        "it",
      +        "id"
      +      ],
      +      "type": "string"
      +    },
      +    "detected": {
      +      "description": "true when the language came from the query's own words, false when lang was sent.",
      +      "type": "boolean"
      +    },
      +    "meaning": {
      +      "type": "string"
      +    },
      +    "understoodAs": {
      +      "description": "How the query was read: the English words searched for, and the filters its words asked for.",
      +      "properties": {
      +        "multiplayer": {
      +          "type": "boolean"
      +        },
      +        "phone": {
      +          "type": "boolean"
      +        },
      +        "words": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "words",
      +        "phone",
      +        "multiplayer"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "applied",
      +    "detected",
      +    "understoodAs",
      +    "meaning"
      +  ],
      +  "type": "object"
      +}
  2. Changed6 schema fields changed
    • changedInput schema / properties / query / description
      Previous value: -"Words to match, such as 'zombie shooter', 'racing', 'puzzle' or 'cozy farm'."New value: +"Words required in the title, description or genre, such as 'zombie shooter' or 'cozy farm'. Use phone and aiMade flags for those constraints instead of adding them as query words. Leave empty or omit for broad discovery with filters."
    • addedOutput schema / properties / aiMadeFilter / properties / canonicalUrl / description
      Added value: +"AI-made reference list, narrowed to the AI-phone list when phone is also true. Other request constraints are not applied to this reference page."
    • addedOutput schema / properties / apiSearch
      Added value: +{
      +  "description": "Public JSON search self-link retaining text, sort, limit, genre, phone, multiplayer and AI-made filters. Public assistant eligibility applies; no owner authorization is included.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / browseAll / description
      Previous value: -"Every game on Foundplay."New value: +"Broader website Browse destination preserving only its supported filters. See browseAllMeaning; it is not the same eligible result set."
    • addedOutput schema / properties / browseAllMeaning
      Added value: +{
      +  "description": "Which request choices the broader website Browse link preserves and which it does not.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / phoneFilter
      Added value: +{
      +  "description": "Present when phone is true, including empty results. Describes recorded support and its limits.",
      +  "properties": {
      +    "applied": {
      +      "const": true,
      +      "type": "boolean"
      +    },
      +    "basis": {
      +      "type": "string"
      +    },
      +    "canonicalUrl": {
      +      "description": "The general phone-games reference list; other request constraints are not applied to this page.",
      +      "type": "string"
      +    },
      +    "limitations": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "applied",
      +    "basis",
      +    "limitations",
      +    "canonicalUrl"
      +  ],
      +  "type": "object"
      +}
  3. Changed20 schema fields changed
    • addedInput schema / properties / aiMade
      Added value: +{
      +  "description": "true requires recorded evidence of AI-assisted creation, using the website's AI-made list rules. False or omitted does not filter by AI use; missing evidence is unknown.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / multiplayer / description
      Previous value: -"true for games people play together, online or on one screen."New value: +"true for catalog multiplayer support, online or on one screen. Does not guarantee online play or a particular player count."
    • changedInput schema / properties / phone / description
      Previous value: -"true for games with touch controls that play on a phone."New value: +"true for catalog phone support, such as touch controls. Not a physical-device test or a guarantee for every iPhone, Android device or browser."
    • changedInput schema / properties / sort / description
      Previous value: -"popular (most played, the default), trending (last 48 hours) or new."New value: +"popular (all-time counted clicks, the default), trending (last 48 hours), new (newest Foundplay listings, not original release dates), or best (the website's quality ranking of eligible originals)."
    • changedInput schema / properties / sort / enum
      Previous value: -[
      -  "popular",
      -  "trending",
      -  "new"
      -]New value: +[
      +  "popular",
      +  "trending",
      +  "new",
      +  "best"
      +]
    • addedOutput schema / properties / aiMadeFilter
      Added value: +{
      +  "description": "Present when aiMade is true, including when no games match.",
      +  "properties": {
      +    "applied": {
      +      "const": true,
      +      "type": "boolean"
      +    },
      +    "basis": {
      +      "type": "string"
      +    },
      +    "canonicalUrl": {
      +      "type": "string"
      +    },
      +    "limitations": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "applied",
      +    "basis",
      +    "limitations",
      +    "canonicalUrl"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / games / items / properties / aiMadeEvidence
      Added value: +{
      +  "description": "Present only for aiMade:true. The recorded signal and public source, not proof of a specific AI workflow or a code audit.",
      +  "properties": {
      +    "kind": {
      +      "enum": [
      +        "ai-game-jam",
      +        "ai-maker-host",
      +        "curated-list",
      +        "listing-statement"
      +      ],
      +      "type": "string"
      +    },
      +    "sourceUrl": {
      +      "description": "Public context for the recorded signal, not an independent code verification. Jam and host pages may not name every matched game.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "sourceUrl"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / games / items / properties / canonicalUrl
      Added value: +{
      +  "description": "The same game page without attribution parameters.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / games / items / properties / listedAt
      Added value: +{
      +  "description": "When this listing was added to Foundplay, in ISO 8601 UTC. Not the game's original release date or a gameplay/device test date.",
      +  "format": "date-time",
      +  "type": "string"
      +}
    • changedOutput schema / properties / games / items / properties / multiplayer / description
      Previous value: -"true: people play it together. false: single-player. null: not known."New value: +"Catalog flag: true for multiplayer, false for single-player, null if unknown. Multiplayer can be online or on one screen; this does not specify a player count."
    • changedOutput schema / properties / games / items / properties / phoneFriendly / description
      Previous value: -"true: plays on phones. false: needs a keyboard. null: not known."New value: +"Catalog flag: true for phone support, false for keyboard/computer, null if unknown. Not a physical-device test or a guarantee for every phone or browser."
    • addedOutput schema / properties / games / items / properties / plays / description
      Added value: +"All-time counted outbound Play clicks, including when sort is trending. Not confirmed gameplay or unique people. See playsMeaning."
    • addedOutput schema / properties / games / items / properties / qualityTier
      Added value: +{
      +  "description": "Present for best order: the catalog's signal-based tier, not a review rating.",
      +  "enum": [
      +    "pick",
      +    "ok"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / games / items / required
      Previous value: -[
      -  "title",
      -  "pitch",
      -  "url",
      -  "type",
      -  "genres",
      -  "phoneFriendly",
      -  "multiplayer",
      -  "plays",
      -  "upvotes",
      -  "creatorX"
      -]New value: +[
      +  "title",
      +  "pitch",
      +  "url",
      +  "canonicalUrl",
      +  "listedAt",
      +  "type",
      +  "genres",
      +  "phoneFriendly",
      +  "multiplayer",
      +  "plays",
      +  "upvotes",
      +  "creatorX"
      +]
    • addedOutput schema / properties / lists / items / properties / canonicalUrl
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / lists / items / required
      Previous value: -[
      -  "title",
      -  "url"
      -]New value: +[
      +  "title",
      +  "url",
      +  "canonicalUrl"
      +]
    • addedOutput schema / properties / listsMeaning
      Added value: +{
      +  "description": "Related lists match by title; their contents are not restricted by the game's requested filters.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / playsMeaning
      Added value: +{
      +  "description": "How the public play count is measured and what it does not establish.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / ranking
      Added value: +{
      +  "description": "Present for best order, including when no eligible game matches.",
      +  "properties": {
      +    "canonicalUrl": {
      +      "type": "string"
      +    },
      +    "limitations": {
      +      "type": "string"
      +    },
      +    "method": {
      +      "type": "string"
      +    },
      +    "minimumCountedPlays": {
      +      "type": "integer"
      +    },
      +    "scope": {
      +      "type": "string"
      +    },
      +    "signals": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "method",
      +    "signals",
      +    "scope",
      +    "minimumCountedPlays",
      +    "canonicalUrl",
      +    "limitations"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "total",
      -  "games",
      -  "lists",
      -  "browseAll"
      -]New value: +[
      +  "total",
      +  "games",
      +  "lists",
      +  "listsMeaning",
      +  "browseAll",
      +  "playsMeaning"
      +]
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "browseAll": {
      +      "description": "Every game on Foundplay.",
      +      "type": "string"
      +    },
      +    "games": {
      +      "items": {
      +        "properties": {
      +          "creatorX": {
      +            "description": "The creator's X handle, without @.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "genres": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "multiplayer": {
      +            "description": "true: people play it together. false: single-player. null: not known.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "phoneFriendly": {
      +            "description": "true: plays on phones. false: needs a keyboard. null: not known.",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "pitch": {
      +            "description": "One line about the game.",
      +            "type": "string"
      +          },
      +          "plays": {
      +            "type": "integer"
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "upvotes": {
      +            "type": "integer"
      +          },
      +          "url": {
      +            "description": "The game's page on Foundplay, with a Play button.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "title",
      +          "pitch",
      +          "url",
      +          "type",
      +          "genres",
      +          "phoneFriendly",
      +          "multiplayer",
      +          "plays",
      +          "upvotes",
      +          "creatorX"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "lists": {
      +      "items": {
      +        "properties": {
      +          "title": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "title",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "total": {
      +      "description": "How many games matched in all.",
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "total",
      +    "games",
      +    "lists",
      +    "browseAll"
      +  ],
      +  "type": "object"
      +}
  5. Changed1 schema field changed
    • changedInput schema / properties / query / description
      Previous value: -"Words to match, such as 'halo', 'zombie shooter', 'mario kart' or 'cozy'."New value: +"Words to match, such as 'zombie shooter', 'racing', 'puzzle' or 'cozy farm'."
  6. Changed1 schema field changed
    • addedInput schema / properties / multiplayer
      Added value: +{
      +  "description": "true for games people play together, online or on one screen.",
      +  "type": "boolean"
      +}
  7. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint and non-destructive behavior, so the repeated 'Read-only' earns no credit. The description does add value beyond them: it discloses that 'best' reflects a website ranking with its own method and limits rather than a review, that aiMade requires recorded provenance rather than being inferred, and that click/upvote figures are counted, which tells the agent how to interpret results.

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?

Front-loaded with the core purpose, then returns, then sort semantics, then filter caveats and language handling. It is dense and every sentence carries information, though the single paragraph is packed tightly enough that a reader must parse several distinct claims in sequence.

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

Completeness5/5

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

For an 8-parameter, all-optional search tool with an output schema and full annotation coverage, the description covers matching logic, ranking semantics, filter preconditions and cross-language behavior. Nothing an agent needs to call it correctly is missing, and return-value detail is properly left to the output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3 and the schema carries the per-parameter detail. The description adds meaning on top: the 'best' sort caveat about method and limits, the provenance condition behind aiMade, and the language behavior for query and pitches, which goes slightly beyond the enum text.

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?

Names a specific verb and resource (search the free browser games listed on Foundplay) and spells out the matching surface: title, one-line description and genres. It also enumerates what comes back (device and multiplayer facts, counted clicks, upvotes, creator credit, page links), so the agent knows exactly what this tool yields without opening the schema.

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?

Gives real routing guidance among the sort modes: default is most played, while 'best' uses the site's quality ranking and is explicitly flagged as not a hands-on review. It does not name any alternative tool (there are no siblings), so there is no when-not-to-use statement, but the conditional advice for 'best' and the aiMade provenance requirement cover the main usage decisions.

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