Skip to main content
Glama
osrs-wikisync-mcp

osrs-wikisync-mcp

by ryandrew14

WikiSync/Hiscores MCP for OSRS

A small personal MCP server that exposes data about an Old School RuneScape account to Claude on demand, to eliminate copy/pasting a bunch if you use Claude to draft a plan or aggregate wiki data. TBH I am now required to use Claude at work so I'm working on getting comfortable with it.

  • All of WikiSync - quests, achievement diaries, skill levels, combat achievements, music tracks, league tasks, collection log.

  • Official HiScores - exact level/xp per skill

Obvious shoutout to the OSRS wiki team and all they do. Ideally I will eventually turn this into a public API, maybe even add it to the wiki.

Demo

Related MCP server: RS3-MCP

Tools

Tool

Description

wikisync(username, section="all", profile="STANDARD")

Sliced WikiSync data. section ∈ quests | achievement_diaries | combat_achievements | collection_log | music_tracks | levels | league_tasks | all. profile ∈ STANDARD | IRONMAN | HARDCORE_IRONMAN | ULTIMATE_IRONMAN.

player_skills(username)

Exact {rank, level, xp} per skill from the official HiScores — the source of truth for XP.

Notes & caveats

  • You have to have WikiSync enabled for this to work fully

  • collection_log is empty until manually synced — the player must press the WikiSync button in the in-game collection log interface (and re-press to resync). The tool surfaces this as a note rather than a bare [].

  • Quest states are decoded: 0 not started, 1 in progress, 2 finished (confirmed from a live payload).

  • combat_achievements and collection_log return numeric ids (not yet decoded to names); quests and diaries are already named.

Requirements

  • Python 3.10+

  • uv

Setup with Claude Desktop

Claude Desktop launches MCP servers with a stripped-down environment (no shell PATH), so use the absolute path to uv. Find it with which uv.

Edit claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config, or ~/Library/Application Support/Claude/ on macOS) and add:

{
  "mcpServers": {
    "osrs-player": {
      "command": "/ABS/PATH/TO/uv",
      "args": [
        "run",
        "--directory", "/ABS/PATH/TO/osrs-wikisync-mcp",
        "osrs-wikisync-mcp"
      ]
    }
  }
}

Then fully quit Claude Desktop and reopen. The server appears under the tools/MCP menu in a chat, and under Settings → Developer. Logs (macos): ~/Library/Logs/Claude/mcp-server-osrs-player.log.

The MCP server stays alive as long as Claude Desktop is open.

Manual setup/run

uv sync
uv run osrs-wikisync-mcp        # stdio (default MCP transport)
# or: uv run python -m osrs_mcp.server

Claude Code can just call a script so honestly no point in using this unless you plan to use Claude Desktop. Eventually I'll deploy this so people can use it on claude.ai and mobile too

# user scope (available in every session); use an absolute path to this repo
claude mcp add --scope user --transport stdio osrs-player \
  -- uv run --directory /ABS/PATH/TO/osrs-wikisync-mcp osrs-wikisync-mcp

claude mcp list   # then /mcp inside a session to see the tools

To iterate on tool I/O and schemas:

uv run fastmcp dev osrs_mcp/server.py

Data sources

  • HiScores API: https://secure.runescape.com/m=hiscore_oldschool/index_lite.ws?player={username}

  • WikiSync API: https://sync.runescape.wiki/runelite/player/{username}/{profile}

Both are called with a descriptive, contactable User-Agent per API etiquette.

Available Tools

2 tools
player_skillsA

Exact level AND xp per skill from the official OSRS HiScores.

Use this whenever exact XP matters — WikiSync stores skill levels only, so this is the source of truth for XP. Returns a mapping of skill name to {rank, level, xp}, including the synthetic "Overall" row.

Inputs: username (required). Returns: object

wikisyncA

Read public WikiSync character data for an OSRS account.

WikiSync covers the account's full public progress surface: quests, achievement diaries, skill levels, combat achievements, music tracks, league tasks, and the collection log. It is a snapshot that exists/updates only if the account runs the WikiSync RuneLite plugin and has logged in.

Inputs: username (required), profile, section. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: player_skills provides exact skill XP from the official HiScores, while wikisync offers a broader snapshot of account progress including quests, diaries, and levels. The overlapping skill levels are differentiated by the presence of XP data in player_skills.

    Naming Consistency3/5

    Both tools use lowercase and underscores are present only in player_skills; wikisync is a single compound word. There is no consistent verb_noun pattern, and the names are simple nouns that describe the data source rather than actions.

    Tool Count3/5

    With only two tools, the server feels minimal but appropriate for its narrow scope of OSRS account data. While one tool covers skills with XP and the other covers the rest of the progress surface, there is no redundancy or bloat.

    Completeness4/5

    The tool set covers the primary data needs for OSRS account progress: exact skill XP via HiScores and a broader summary via WikiSync. However, there is a minor gap in that no tool provides real-time updates or specific quest details independently, but the server is read-only and focused on snapshot data.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables access to RuneScape 3 data, including real-time Grand Exchange prices, item information, historical price trends, and player statistics. Supports multiple game modes and provides comprehensive RuneScape Wiki API integration through natural language.
      13
      54 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with RuneScape 3 and OSRS ecosystems through tools for Grand Exchange prices, player stats, and server data.
      18 npm
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search the OSRS Wiki, lookup Grand Exchange prices, and access synced player data (bank, skills, quests, etc.) via local RuneLite plugin files.
      13
      10 npm
      1
      BSD 2-Clause "Simplified"
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Code to search the Old School RuneScape Wiki, fetch page content, get plain-text extracts, and render images as ASCII art.
      1
      -