TF2 Wiki

io.github.yusufafPublished by GitHub account yusufafv0.1.2Updated Oct 30, 2026

Live Team Fortress Wiki access: search, pages, weapon stats, loadouts, patch notes.

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Unofficial MCP server that gives an assistant live access to the Team Fortress 2 Wiki: search, pages, weapon stats, loadouts, cosmetics and patch notes.

What you can do
  • Search the wiki and read pages as wikitext, plaintext or HTML, with summaries and section tables of contents
  • List recently edited pages by namespace
  • Fetch structured weapon stats parsed from infoboxes and list all weapons for a class
  • Look up cosmetic item infobox data and items added in a given event or update
  • Retrieve patch notes for a named update or patch page
When to use it
Useful when you want an assistant to answer TF2 questions from the actual wiki instead of guessing: weapon damage and attributes, class loadouts, cosmetic details, event item lists and patch notes.
Requirements
Runs locally over stdio as a PyPI package; the README requires uv, with the server started via uvx. No accounts, API keys or environment variables are declared. Network access to the TF2 Wiki is needed because content is fetched live.
Before you install
Read-only lookups, but every request goes to the external TF2 Wiki site, so queries and page titles leave your machine. It is unofficial fan tooling, not affiliated with Valve or the wiki contributors; wiki content is not redistributed and users are responsible for complying with Valve's terms.

Installation

In SourceWeft

  1. Open TF2 Wiki in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

tf2-wiki-mcp

An MCP server that exposes the Team Fortress Wiki to LLM clients (Claude Desktop, Claude Code, Cursor, VS Code) over stdio.

[Install in VS Code] [Install in VS Code Insiders] [Install in Visual Studio] [Install in Cursor]

Not affiliated with Valve Corporation or the Team Fortress Wiki contributors. Team Fortress 2 is a trademark of Valve Corporation. This is unofficial fan tooling.

What it does

Gives an LLM live, accurate access to TF2 wiki content so it stops guessing at weapon stats, patch notes, and cosmetic details.

  • Generic wiki access — search, fetch pages, get summaries, list recent changes.
  • TF2 domain tools — structured weapon stats, class loadouts, cosmetic lookup, event item lists, patch notes.

Tools

ToolPurpose
search_wiki(query, limit)Full-text search
get_page(title, format)Page content as wikitext, plain, or html
get_page_summary(title)Lead-section plaintext
get_page_sections(title)Section TOC for selective fetching
get_recent_changes(limit, namespace)Recently edited pages
get_weapon_stats(weapon_name)Parsed weapon infobox → structured stats
list_class_loadout(class_name)All weapons in a class's wiki category
get_cosmetic(name)Cosmetic item infobox params
list_event_items(event_name)Items added in an update/event
get_patch_notes(update_name)Patch notes for a specific update

Plus: resource tf2wiki://main, prompts analyze_loadout and compare_weapons.

Installation

Requires uv (which manages the Python toolchain for you). Once installed, uvx tf2-wiki-mcp will fetch and run the server on demand — no manual clone needed.

Standard config works in most MCP clients:

json
{  "mcpServers": {    "tf2-wiki-mcp": {      "command": "uvx",      "args": ["tf2-wiki-mcp"],      "env": {}    }  }}
Claude Desktop

Add the standard config above to claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop. The TF2 wiki tools appear in the tool picker.

Claude Code
bash
claude mcp add tf2-wiki-mcp -- uvx tf2-wiki-mcp
Codex

Add to ~/.codex/config.toml:

toml
[mcp_servers.tf2-wiki-mcp]command = "uvx"args = ["tf2-wiki-mcp"]

See the Codex MCP docs.

Cursor

[Install in Cursor]

Or add the standard config to ~/.cursor/mcp.json.

Gemini CLI

Add the standard config to your Gemini CLI settings.json per the Gemini CLI MCP guide.

VS Code

[Install in VS Code]

Or via the VS Code CLI:

bash
code --add-mcp '{"name":"tf2-wiki-mcp","command":"uvx","args":["tf2-wiki-mcp"],"env":{}}'

See the VS Code MCP guide for details.

VS Code Insiders

[Install in VS Code Insiders]

Or via the CLI:

bash
code-insiders --add-mcp '{"name":"tf2-wiki-mcp","command":"uvx","args":["tf2-wiki-mcp"],"env":{}}'
Visual Studio

[Install in Visual Studio]

Or manually:

  1. Open the GitHub Copilot Chat window.
  2. Click the tools icon (🛠️) → + Add Server.
  3. Fill in: Server ID tf2-wiki-mcp, Type stdio, Command uvx, Arguments tf2-wiki-mcp.
  4. Save.

See the Visual Studio MCP docs.

GitHub Copilot Coding Agent
json
{  "mcpServers": {    "tf2-wiki-mcp": {      "command": "uvx",      "args": ["tf2-wiki-mcp"],      "env": {},      "type": "local",      "tools": ["*"]    }  }}

Add this in repository settings under Copilot → Coding agent. See the Copilot Coding Agent MCP docs.

Development

Run from a local clone instead of PyPI:

bash
git clone https://github.com/yusufaf/tf2-wiki-mcpcd tf2-wiki-mcpuv sync --devuv run pytest              # offline, uses recorded cassettesuv run pytest --live       # also hits the real wiki

To point an MCP client at the local checkout:

json
{  "mcpServers": {    "tf2-wiki-mcp": {      "command": "uv",      "args": ["run", "--directory", "/absolute/path/to/tf2-wiki-mcp", "tf2-wiki-mcp"]    }  }}

Licensing & Attribution

Code: MIT (see LICENSE).

Wiki content: Not redistributed. This project contains zero scraped wiki data. All page content is fetched live from wiki.teamfortress.com at the user's request and returned directly to the user's LLM client — the same posture as a browser extension.

Wiki content is © its respective contributors under Valve's Steam Subscriber Agreement (Game Site terms). Users of this tool are responsible for compliance with Valve's terms. Code license ≠ content license: MIT covers this codebase, not the wiki content it fetches.

Requests to the wiki include a descriptive User-Agent (tf2-wiki-mcp/<version> (https://github.com/yusufaf/tf2-wiki-mcp)) per MediaWiki etiquette and respect maxlag/Retry-After responses.

Contributing

Don't check in scraped wiki text. Infobox examples for parser tests are fine (short, fair-use-grade fixtures). Full page dumps are not.

Source: README.md at commit 46ed09b

Tools

10

search_wiki

Search Wiki

Full-text search the TF2 Wiki. Returns title + snippet + wordcount for each hit.

Parameterslimitqueryrequired

get_page

Get Page

Fetch a single TF2 Wiki page. `format` picks raw wikitext, plaintext extract, or rendered HTML.

Parameterstitlerequiredformat

get_page_summary

Get Page Summary

Lead-section plaintext summary of a page. Fast context anchor.

Parameterstitlerequired

get_page_sections

Get Page Sections

Section table-of-contents for a page; use before get_page to fetch selectively.

Parameterstitlerequired

get_recent_changes

Get Recent Changes

Recently edited pages in the given namespace (0 = main/articles).

Parameterslimitnamespace

get_weapon_stats

Get Weapon Stats

Fetch a weapon page and return structured stats parsed from its infobox. Returns damage, rate-of-fire, reload, clip size, attributes (+/- effects), etc.

Parametersweapon_namerequired

list_class_loadout

List Class Loadout

List all weapons for the given class. Intersects Category:<Class> with Category:Weapons on the wiki.

Parametersclass_namerequired

get_cosmetic

Get Cosmetic

Fetch a cosmetic item page and return its infobox params.

Parametersnamerequired

list_event_items

List Event Items

List items added during a given TF2 event/update (e.g. 'Jungle Inferno Update', 'Smissmas 2023').

Parametersevent_namerequired

get_patch_notes

Get Patch Notes

Fetch patch notes for a named update or patch page (e.g. 'October 5, 2023 Patch').

Parametersupdate_namerequired

Version history

1
  1. v0.1.2LatestOct 29, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts