speedrun.com MCP server for AI agents

Let Claude, ChatGPT or your own agent read speedrun.com: 3 typed functions through one MCP server. No speedrun.com API key needed.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just speedrun.com

An MCP server for speedrun.com alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/speedrun
Every site

One MCP server for speedrun.com and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 3
  • categoriesList all categories for a game, including variables and values.

    Arguments

    NameTypeRequired
    gameIdstringYes

    Returns Category[]

    interface Category {
      id: string;
      name: string;
      weblink: string;
      type: string;            // "per-game" | "per-level"
      rules?: string;
      players?: { type: string; value?: number }
      miscellaneous?: boolean; // hidden from the default leaderboard view
      variables?: { data: CategoryVariable[] }
    }
    
    interface CategoryVariable {
      id: string;
      name: string;
      mandatory: boolean;
      "user-defined": boolean;
      // submitRun takes the KEY of a choice, never its label
      values?: { choices?: Record<string, { label: string }>; default?: string }
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/speedrun/categories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.speedrun.categories({ gameId: "76rxvqq6" });
  • findGameSearch for a game by name, returning metadata including ID, platforms, and rules.

    Arguments

    NameTypeRequired
    namestringYes

    Returns Game[]

    interface Game {
      id: string;
      names: { international: string; japanese?: string };
      abbreviation: string;
      weblink: string;
      released: number;
      "release-date": string;
      platforms?: string[];
      ruleset?: { "require-video": boolean; "require-verification": boolean; "show-milliseconds": boolean };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/speedrun/findGame

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.speedrun.findGame({ name: "Wetrix" });
  • platformsList all platforms, optionally filtered to a specific game.

    Arguments

    NameTypeRequired
    gameIdstringNo

    Returns Platform[]

    interface Platform {
      id: string;
      name: string;
      released?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/speedrun/platforms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.speedrun.platforms();

Use it from code