`bgg_search_games`

Pack: boardgamegeek · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/bgg_search_games for the schema, then POST the same URL with its arguments for the data.

Search BoardGameGeek for board games and expansions by name. Returns BoardGameGeek ids to pass to bgg_get_games. Requires your own BoardGameGeek application token as _apiKey.

Parameters

Name	Type	Required	Description
`query`	string	yes	Game name or fragment, e.g. “gloomhaven”.
`exact`	boolean	no	Exact name match only (default false).
`include_expansions`	boolean	no	Also return expansions (default false: base games only).
`limit`	number	no	Max results to return (default 25, max 100). The response carries total and truncated.
`_apiKey`	string	no

Example call

Arguments

{
  "query": "gloomhaven",
  "_apiKey": "your-boardgamegeek-token"
}

curl

curl -X POST https://gateway.pipeworx.io/boardgamegeek/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bgg_search_games","arguments":{"query":"gloomhaven","_apiKey":"your-boardgamegeek-token"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('bgg_search_games', {
  "query": "gloomhaven",
  "_apiKey": "your-boardgamegeek-token"
});

Response shape

Field	Type	Description
`total`	number \| null
`returned`	number \| null
`truncated`	boolean
`results`	array
`hint`	string \| null
`source`	string \| null
`fetched_at`	string \| null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": [
        "number",
        "null"
      ]
    },
    "returned": {
      "type": [
        "number",
        "null"
      ]
    },
    "truncated": {
      "type": "boolean"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "number",
              "null"
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "year_published": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      }
    },
    "hint": {
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": [
        "string",
        "null"
      ]
    },
    "fetched_at": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the boardgamegeek pack

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

See Getting Started for client-specific install steps.

bgg_search_games