MCP Server Runescape

What stefan-xyz/mcp-server-runescape MCP server does

The stefan-xyz/mcp-server-runescape MCP server connects an MCP client to RuneScape and Old School RuneScape data. Its tools cover Grand Exchange items, price history, player hiscores, skill and activity rankings, current online population, and total accounts that can access RuneScape services.

The server is intended for information lookup rather than game control. It does not provide tools for playing the game, placing trades, changing accounts, or performing other in-game actions. The README says the implementation favors API endpoints that support both RuneScape and OSRS data.

How it works

An MCP-compatible client sends natural-language requests to the exposed tools. The server obtains data from RuneScape Wiki API endpoints and returns structured results for the client to use in its response.

Item lookups can include the current Grand Exchange price, price movement over 24 hours and 30, 90, or 180 days, item name, category, examine text, image, membership status, and ID. Historical price queries cover daily prices and averages for the previous 180 days. Player and ranking requests return values such as names, ranks, levels, experience, and activity scores.

Setup and configuration

The package can be run through npx using the following MCP configuration:

{
  "mcpServers": {
    "mcp-server-runescape": {
      "command": "npx",
      "args": ["-y", "mcp-server-runescape"]
    }
  }
}

The README identifies Claude Desktop and Cursor as supported examples. After adding the server to a client configuration, restart the client so it loads the new MCP process. A source-based setup is also documented: install Node.js, clone the repository, install dependencies with yarn or npm install, and configure Node to run src/server.js. Source configuration requires replacing the example path with the actual local repository path.

Tools and capabilities

• get_item_details looks up tradeable items, including current price, trends, category, description, image, membership status, and ID.
• get_item_price_history returns daily item prices and averages for the last 180 days.
• get_player_hiscore retrieves a player’s rank, skill level, experience, or activity score.
• get_top_rankings returns up to 50 players for a selected skill or activity, with names, scores, and ranks.
• get_player_count reports the current number of online players in RuneScape and OSRS.
• get_rsuser_total reports the current total of accounts able to access any RuneScape form, including accounts associated with FunOrb or particular RuneScape versions.

Limitations and notes

The stefan-xyz/mcp-server-runescape MCP server relies on the availability and coverage of the RuneScape Wiki API endpoints. Price history is limited to the previous 180 days according to the documented tool behavior. Item details apply to tradeable Grand Exchange items. No API key, OAuth flow, or other credential requirement is documented in the supplied material.

The repository also mentions an optional debugger or inspector workflow through its development scripts, but that is separate from running the MCP server for normal client use.