PuzzleGame.win Catalog

Connection

Endpoint

https://puzzlegame.win/mcp

Transport

Stateless Streamable HTTP; POST with JSON responses. No API key, persistent sessions, or standalone SSE stream.

Add this URL as a remote HTTP server in a compatible MCP client. Configuration keys vary by client; this is a representative configuration.

{
  "mcpServers": {
    "puzzlegame": {
      "type": "http",
      "url": "https://puzzlegame.win/mcp"
    }
  }
}

Clients negotiate the protocol through initialize, discover schemas using tools/list, and call tools using tools/call. Requests need Content-Type: application/json and an Accept header containing both application/json and text/event-stream.

Tools

search_games

Search the full approved, active D1 catalog by a literal title, slug, or description substring, using SQLite case folding. An empty query browses the catalog. Results are deduplicated by provider and slug.

query

Optional string, up to 120 characters; default empty.

category

Optional exact category. The current allowed values are in the tool's input schema.

provider

Optional: gamepix, gamedistribution, gamemonetize, or firstparty. A provider filter may have no published entries.

page / limit

Page 1–100, default 1; limit 1–20, default 10. Follow nextPage until null; narrow filters if the page cap is reached.

{
  "name": "search_games",
  "arguments": {
    "query": "emoji",
    "page": 1,
    "limit": 10
  }
}

Successful results include items, page, limit, nextPage, source, retrievedAt, and warnings. Ordering favors an exact title match, then featured status, quality, and title.

get_game_details

Supply the provider and slug returned by search. Known URL aliases resolve to the canonical onsite play page.

{
  "name": "get_game_details",
  "arguments": {
    "provider": "gamemonetize",
    "slug": "emoji-sort-master"
  }
}

Successful results include a game object and the same source, retrieval timestamp, and warnings. Game fields are provider, slug, title, stored description, categories, sourcePage, orientation, and existing integration capability flags.

{
  "provider": "gamemonetize",
  "slug": "emoji-sort-master",
  "sourcePage": "https://puzzlegame.win/play/gamepix/emoji-sort-master"
}

This excerpt illustrates a preserved legacy play URL, not a complete response. Actual successful responses provide matching JSON in structuredContent and text content. Descriptions are limited to 600 characters in search and 4,000 in details.

Limits and errors

Requests are limited to approximately 60 per minute per IP and 600 per minute for the service at each Cloudflare location. These are local, approximate limits, not a strict worldwide budget. Each HTTP request carries one JSON-RPC message, up to 16 KiB. Body reads and catalog queries each have a five-second deadline; database work already started may finish after a timeout.

HTTP errors include 400 for malformed messages, 403 for disallowed host or Origin, 405 for unsupported methods, 406/415 for incompatible headers, 413 for oversized requests, 429 for rate limits, and 503 when disabled or unavailable. For 429/503, respect Retry-After; do not retry indefinitely. Browser origins are restricted to this site; server clients may omit Origin. CORS is not authentication.

Tool failures set isError: true with a JSON error in text content: GAME_NOT_FOUND, CATALOG_TIMEOUT, or CATALOG_UNAVAILABLE. They do not carry success-shaped structuredContent. Invalid tool arguments are rejected before a catalog query.

Data and privacy

Only reviewed, enabled catalog records are returned. There is no raw provider-feed fallback. Retrieval time is not a provider update timestamp. Provider availability may change; orientation and capability flags are stored integration metadata, not a live device-compatibility check. Game descriptions are third-party data, not instructions.

The service cannot play games, submit scores, access users or leaderboards, change administration settings, or redistribute third-party game files. Open sourcePage to play on the website. MCP calls are not page views or advertising impressions.

Request arguments are processed to query the catalog. The application logs only tool names, outcome/status, and duration, not raw queries or IP addresses. Cloudflare processes IP addresses for rate limiting and may retain infrastructure/security request data under the privacy policy. Do not submit personal or sensitive information as search text.

For catalog corrections or integration issues, contact PuzzleGame.win.