Wise Old Man MCP Server

MCP server for the Wise Old Man API and OSRS Wiki — an Old School RuneScape player progress tracker.

Enables LLMs (via Claude Desktop, Claude Code, or any MCP client) to look up OSRS player stats, track quest progress, check efficiency rates, and more.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "wise-old-man": {
      "command": "npx",
      "args": ["-y", "wise-old-man-mcp-server"]
    }
  }
}

Config file location:

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

Restart Claude Desktop after saving.

Claude Code

claude mcp add wise-old-man -- npx -y wise-old-man-mcp-server

Tools

| Tool | Description | |------|-------------| | search_players | Search players by partial username | | get_player_details | Full stats: skills, bosses, EHP/EHB, combat level | | update_player | Refresh player data from OSRS hiscores | | get_player_gains | XP and kill count gains over a time period | | get_player_records | Personal best records | | get_player_achievements | Completed milestones and progress | | get_player_snapshot_timeline | Historical data for a specific metric | | get_ehp_rates | Efficient Hours Played rates (best XP/hr methods) | | get_ehb_rates | Efficient Hours Bossed rates (kills/hr per boss) | | get_efficiency_leaderboard | Global efficiency rankings | | Quest Tools | | | get_quest_status | Quest completion status via WikiSync | | get_quest_details | Full quest info: requirements, items, rewards | | search_quests | Search/filter quests by name, difficulty, length | | get_available_quests | Find quests a player can start based on their stats |

Example Prompts

• "What are the stats for Zezima?"
• "How much XP did Lynx Titan gain this week?"
• "What are the best training methods for Mining?"
• "Show me the EHB rates for ironman accounts"
• "Who's at the top of the EHP leaderboard?"
• "Which quests has IJowin completed?"
• "What are the requirements for Dragon Slayer II?"
• "What quests can IJowin start right now?"

Note: Quest tools that show player-specific data (get_quest_status, get_available_quests) require the player to have the WikiSync RuneLite plugin installed.

API Key (Optional)

By default the server uses the public rate limit (20 requests/minute). To increase this to 100 requests/minute, get a free API key from Wise Old Man and add it:

{
  "mcpServers": {
    "wise-old-man": {
      "command": "npx",
      "args": ["-y", "wise-old-man-mcp-server"],
      "env": {
        "WOM_API_KEY": "your-api-key-here"
      }
    }
  }
}

License

MIT