`search_games`

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

Search for board games by name. Returns title, year, player count, playtime, rating, price, and description. Use this to find games before fetching full details.

Parameters

Name	Type	Required	Description
`name`	string	yes	Board game name or partial name to search for, e.g. “Catan” or “Ticket to Ride”
`limit`	number	no	Number of results to return (1–100, default 10)

Example call

Arguments

{
  "name": "Catan",
  "limit": 10
}

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":"search_games","arguments":{"name":"Catan","limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_games', {
  "name": "Catan",
  "limit": 10
});

More examples

{
  "name": "Ticket to Ride"
}

Response shape

Always returns: count, games

Field	Type	Description
`count`	number	Total number of games matching the search
`games`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of games matching the search"
    },
    "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.

search_games