osrs-companion

An MCP server for Old School RuneScape that gives AI assistants access to wiki search, Grand Exchange prices, and your synced player data — all running locally on your machine.

Features

• Wiki Search — Search the OSRS Wiki for any article

• Page Summaries — Get introductory summaries of wiki pages

• GE Prices — Look up current Grand Exchange buy/sell prices

• WikiSync Player Data — Fetch player data via the WikiSync plugin

• Local Player Sync — Read detailed player data saved by the companion RuneLite plugin (bank, skills, quests, equipment, inventory, diaries, combat achievements)

Related MCP server: RuneScape Wiki MCP Server

Prerequisites

For the local player sync tools, install the OSRS MCP Companion RuneLite plugin. Wiki search, summaries, and GE prices work without it.

Installation

Claude Code / Claude Desktop

Add to your MCP configuration:

{
  "mcpServers": {
    "osrs-companion": {
      "command": "npx",
      "args": ["-y", "osrs-companion"]
    }
  }
}

Manual

npx -y osrs-companion

Available Tools

Wiki Tools

Player Sync Tools (requires RuneLite plugin)

How It Works

The MCP server runs locally via stdio transport. Wiki and price tools fetch from public OSRS APIs. Player sync tools read JSON files from ~/.runelite/osrs-companion/ that are written by the companion RuneLite plugin.

No data is stored in the cloud. No API keys required.

Attribution

Wiki content returned by the search and summary tools is sourced from the Old School RuneScape Wiki, which is licensed under CC BY-NC-SA 3.0. All wiki tool responses include an attribution notice automatically.

Grand Exchange price data is provided by the OSRS Wiki Prices API. Player data is fetched via the WikiSync API or read from local files saved by the RuneLite plugin — neither contains wiki article content.

License

BSD 2-Clause "Simplified" License. See LICENSE.