Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

speedrun.com

PYPI · SPEEDRUN-MCP · 2 COMPONENTS · SCANNED SEP 20

speedrun.com records, leaderboards (subcategories, ILs), players, PBs, moderation. No key needed.

+33 this week 57 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security50
  • Malware scan not yet available for this package.Unverified
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs setuptools.build_meta at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
  • 0 of 29 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency45
Schema Quality & AI Usability81
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 1660 tokens (~103/item across 16 items; 16 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (25% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 16 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

How do I install the speedrun.com MCP server?

speedrun.com runs locally as a PyPI package, launched with uvx speedrun-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · speedrun-mcp

# add to Claude Code
claude mcp add williamcodes-speedrun-mcp -- uvx speedrun-mcp
// .cursor/mcp.json
{
  "mcpServers": {
    "williamcodes-speedrun-mcp": {
      "command": "uvx",
      "args": [
        "speedrun-mcp"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "williamcodes-speedrun-mcp": {
      "command": "uvx",
      "args": [
        "speedrun-mcp"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add williamcodes-speedrun-mcp -- uvx speedrun-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "williamcodes-speedrun-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "speedrun-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add williamcodes-speedrun-mcp --command uvx --arg speedrun-mcp
# ~/.hermes/config.yaml
mcp_servers:
  williamcodes-speedrun-mcp:
    command: "uvx"
    args: ["speedrun-mcp"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "williamcodes-speedrun-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "speedrun-mcp"
      ]
    }
  }
}
# add to Vellum
assistant mcp add williamcodes-speedrun-mcp -t stdio -c uvx -a speedrun-mcp
// mcp.json
{
  "mcpServers": {
    "williamcodes-speedrun-mcp": {
      "command": "uvx",
      "args": [
        "speedrun-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 18 Sept 26 +33
    • Injection markers: unverified → pass security
    • First check of Judged manipulation: pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: unverified → 100 functional
    • MCP protocol: unverified → pass functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: excellent functional
    • First check of Destructive annotations: pass functional
    • First check of Schema quality: pass functional
    • First check of Tool coverage: 100 functional
    • First check of Tool coverage: 25 functional
    • Package version: 0.3.1 → 0.3.4 functional
    • Package version: 0.3.1 → 0.3.3 functional
  • 7 Sept 26 −15
    • Malware scan: pass → unverified security
  • 5 Sept 26 +15
    • Malware scan: unverified → pass security
  • 1 Sept 26 −15
    • Malware scan: pass → unverified security
  • 30 Aug 26 +15
    • Malware scan: unverified → pass security
  • 26 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 24 Aug 26 −15
    • Malware scan: pass → unverified security
  • 22 Aug 26 39
    • Malware scan: unverified → pass security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 20 Sept 2026 · Analysed pypi/speedrun-mcp@0.3.4

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted setuptools.build_meta

Background: Why install scripts are a supply-chain risk →

Dependencies 29 packages
Packages resolved 29
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 16 exposed · ~1,537 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
get_game ~85

Get a game's details plus its categories (and optionally its levels). The embedded categories give you the ``category_id`` needed for ``get_leaderboard``.

NameTypeReqDescription
gamestringyesGame id or abbreviation (e.g. 'sm64' or 'o1y9wo6q').
include_levelsbooleanAlso include individual levels (for IL leaderboards).

No output schema declared.

No examples provided.

get_game_records ~119

Get a game's records across all its categories in one call. With ``top=1`` (default) this is every category's world record at once — handy for "show me all the records for <game>". ``include_levels=True`` also pulls every individual-level board, which can be large for level-heavy games.

NameTypeReqDescription
gamestringyesGame id or abbreviation.
include_levelsbooleanInclude individual-level boards as well as full-game.
topintegerPlaces per category (1 = world records).

No output schema declared.

No examples provided.

get_leaderboard ~202

Get a ranked leaderboard for a game/category (full-game or individual level). Players, subcategory labels and the category name are resolved for you. For subcategory filters, discover ids with ``list_variables`` first.

NameTypeReqDescription
categorystringyesCategory id or URL slug (e.g. '120_Star').
dateISO date; only runs on or before this date.
emulatorsTrue = emulators only, False = real devices only.
gamestringyesGame id or abbreviation.
levelLevel id for an individual-level (IL) leaderboard.
platformPlatform id to filter by.
regionRegion id to filter by.
timingSort by 'realtime', 'realtime_noloads', or 'ingame'.
topintegerReturn the top N places.
variablesSubcategory/variable filters as {variable_id: value_id}.

No output schema declared.

No examples provided.

get_run ~38

Get a run's players, times, game/category, status, system and variable values.

NameTypeReqDescription
run_idstringyesThe run's id.

No output schema declared.

No examples provided.

get_series ~105

Get a series' details and (by default) the games it contains. The returned game ids/abbreviations feed the other tools (``get_game``, ``list_categories``, ``get_leaderboard``).

NameTypeReqDescription
game_limitintegerMax games to list.
game_offsetintegerStart offset for the games page.
include_gamesbooleanAlso list the games in the series.
seriesstringyesSeries id or abbreviation.

No output schema declared.

No examples provided.

get_user_personal_bests ~89

Get a player's personal best runs across all games, with game/category names. ``/personal-bests`` is unpaginated, so ``total_available`` is the player's true PB count and ``returned`` is how many came back after applying ``limit``.

NameTypeReqDescription
limitintegerMax personal bests to return.
userstringyesUser id or exact username.

No output schema declared.

No examples provided.

get_world_record ~142

Get the current world record (place 1) for a game/category. A convenience wrapper over ``get_leaderboard``. Returns the leaderboard metadata plus ``world_record`` (the single fastest run, or ``None`` if the leaderboard is empty) and ``tied`` (any other runs also at place 1; usually empty).

NameTypeReqDescription
categorystringyesCategory id or URL slug (e.g. '120_Star').
gamestringyesGame id or abbreviation.
levelLevel id for an IL world record.
variablesSubcategory/variable filters as {variable_id: value_id}.

No output schema declared.

No examples provided.

list_categories ~40

List a game's categories (e.g. 'Any%', '120 Star'), with their ids and rules.

NameTypeReqDescription
gamestringyesGame id or abbreviation.
NameTypeReqDescription
resultarrayyes

No examples provided.

list_platforms ~60

List speedrun.com platforms (consoles/systems) with their ids and names. Use a returned ``id`` as the ``platform`` filter for ``get_leaderboard`` (the leaderboard API requires the platform *id*, not its name).

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultarrayyes

No examples provided.

list_regions ~65

List speedrun.com regions (e.g. USA/NTSC, EUR/PAL) with their ids and names. Use a returned ``id`` as the ``region`` filter for ``get_leaderboard`` (the leaderboard API requires the region *id*, not its name).

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultarrayyes

No examples provided.

list_runs ~154

List runs with filters — e.g. a player's recent submissions, or a game's verified/rejected runs. Newest first; combine filters to narrow down. For just one game's moderation queue, ``list_unverified_runs`` is simpler.

NameTypeReqDescription
categoryFilter to a category id.
examinerFilter to runs examined by this user id or username.
gameFilter to a game (id or abbreviation).
limitintegerMax runs to return.
offsetintegerStart offset; use next_offset to continue.
statusFilter by status: 'new', 'verified', or 'rejected'.
userFilter to a player's runs (user id or username).

No output schema declared.

No examples provided.

list_unverified_runs ~91

List a game's runs awaiting verification — the moderation queue. A public read (no API key needed). Pair with ``verify_run`` / ``reject_run`` (which do require a moderator key) to clear the queue.

NameTypeReqDescription
gamestringyesGame id or abbreviation.
limitintegerMax runs to return.
offsetintegerStart offset; use next_offset to continue.

No output schema declared.

No examples provided.

list_variables ~97

List a game's variables — the subcategories and filters a leaderboard accepts. Each variable has an id and a ``values`` map of {value_id: label}. Pass these to ``get_leaderboard``/``get_world_record`` as ``variables={variable_id: value_id}`` to target a specific subcategory (e.g. '16 Star', difficulty 'Hard').

NameTypeReqDescription
gamestringyesGame id or abbreviation.
NameTypeReqDescription
resultarrayyes

No examples provided.

search_games ~87

Fuzzy-search games by name. Returns ids, abbreviations and release years. Use the returned ``id`` (or ``abbreviation``) with the other tools.

NameTypeReqDescription
limitintegerMax games to return.
namestringyesGame title or partial title containing a Latin letter or ASCII digit.
offsetintegerStart offset; use next_offset to continue.

No output schema declared.

No examples provided.

search_series ~95

Fuzzy-search game series (e.g. 'Mario', 'Zelda') by name. A series groups related games; pass a returned id to ``get_series`` to list the games it contains.

NameTypeReqDescription
limitintegerMax series to return.
namestringyesSeries title or partial title containing a Latin letter or ASCII digit.
offsetintegerStart offset; use next_offset to continue.

No output schema declared.

No examples provided.

search_users ~68

Search for speedrun.com users by name. Returns ids, countries and signup dates.

NameTypeReqDescription
limitintegerMax users to return.
namestringyesUsername (or partial), at least 3 characters.
offsetintegerStart offset; use next_offset to continue.

No output schema declared.

No examples provided.

Common questions

What is the speedrun.com MCP server?

speedrun.com is an MCP server listed in the public MCP registry as io.github.williamcodes/speedrun-mcp. speedrun.com records, leaderboards (subcategories, ILs), players, PBs, moderation. No key needed. This page covers its PyPI package (speedrun-mcp).

Is the speedrun.com MCP server safe to use?

speedrun.com scores 57 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the speedrun.com MCP server expose?

speedrun.com exposes 16 tools: search_games, get_game, list_categories, list_variables, get_leaderboard, and 11 more. Their descriptions and schemas cost roughly 1,537 tokens of context every time the server is loaded.

Is the speedrun.com MCP server still maintained?

speedrun.com is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the speedrun.com MCP server under?

speedrun.com declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.