`hot_games`

Pack: boardgames · Endpoint: https://gateway.pipeworx.io/boardgames/mcp

Get the most popular board games ranked by current buzz. Returns title, year, player count, playtime, rating, and rank. Use this to discover trending games.

Parameters

Name	Type	Required	Description
`limit`	number	no	Number of results to return (1–100, default 10)

Example call

Arguments

{
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/boardgames/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hot_games","arguments":{"limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('hot_games', {
  "limit": 20
});

Response shape

Always returns: count, games

Field	Type	Description
`count`	number	Total number of trending games
`games`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of trending games"
    },
    "games": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Board Game Atlas game ID"
          },
          "name": {
            "type": "string",
            "description": "Game name"
          },
          "year_published": {
            "type": [
              "number",
              "null"
            ],
            "description": "Year the game was published"
          },
          "min_players": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minimum number of players"
          },
          "max_players": {
            "type": [
              "number",
              "null"
            ],
            "description": "Maximum number of players"
          },
          "min_playtime": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minimum playtime in minutes"
          },
          "max_playtime": {
            "type": [
              "number",
              "null"
            ],
            "description": "Maximum playtime in minutes"
          },
          "min_age": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minimum recommended age"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Preview of the game description"
          },
          "image_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Full-size image URL"
          },
          "thumb_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Thumbnail image URL"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Board Game Atlas URL for the game"
          },
          "price": {
            "type": [
              "string",
              "null"
            ],
            "description": "Current price"
          },
          "msrp": {
            "type": [
              "number",
              "null"
            ],
            "description": "Manufacturer suggested retail price"
          },
          "average_user_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average user rating"
          },
          "num_user_ratings": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of user ratings"
          },
          "rank": {
            "type": [
              "number",
              "null"
            ],
            "description": "Overall rank"
          },
          "trending_rank": {
            "type": [
              "number",
              "null"
            ],
            "description": "Trending rank"
          },
          "primary_publisher": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary publisher name"
          },
          "primary_designer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary designer name"
          }
        },
        "required": [
          "id",
          "name",
          "year_published",
          "min_players",
          "max_players",
          "min_playtime",
          "max_playtime",
          "min_age",
          "description",
          "image_url",
          "thumb_url",
          "url",
          "price",
          "msrp",
          "average_user_rating",
          "num_user_ratings",
          "rank",
          "trending_rank",
          "primary_publisher",
          "primary_designer"
        ]
      }
    }
  },
  "required": [
    "count",
    "games"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "boardgames": {
      "url": "https://gateway.pipeworx.io/boardgames/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hot_games