`search_games`

Pack: speedrun · 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/search_games for the schema, then POST the same URL with its arguments for the data.

Search the Speedrun.com database for games by name. Returns matching games with their ID (needed for get_categories and get_leaderboard), abbreviation, release year, and weblink. Example: search_games({ query: “super mario 64”, max: 5 })

Parameters

Name	Type	Required	Description
`query`	string	yes	Game name or keyword to search for, e.g. “super mario 64”, “celeste”
`max`	number	no	Maximum number of games to return (default 10)
`_apiKey`	string	no	Optional speedrun.com API key for authenticated access; omit to use the shared platform key

Example call

Arguments

{
  "query": "super mario 64",
  "max": 5
}

curl

curl -X POST https://gateway.pipeworx.io/speedrun/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_games","arguments":{"query":"super mario 64","max":5}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_games', {
  "query": "super mario 64",
  "max": 5
});

More examples

{
  "query": "celeste"
}

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 speedrun pack

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

See Getting Started for client-specific install steps.

search_games