home / mcp / runescape wiki mcp server

RuneScape Wiki MCP Server

Provides up-to-date RS3 prices, item data, time-series, and hiscores via MCP endpoints.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "birdwell-runescape-wiki-mcp": {
      "command": "node",
      "args": [
        "/path/to/runescape-wiki-mcp/dist/index.js"
      ]
    }
  }
}

You run a Model Context Protocol (MCP) server that exposes RuneScape Wiki APIs, including real-time Grand Exchange prices, item data, time-series price data, and player statistics for RS3. This server is useful for integrating RuneScape data into your applications or chat assistants, offering a unified access point through MCP-compatible clients and tools.

How to use

You connect to the server from an MCP client by referencing the server through a standard MCP configuration. Once connected, you can query latest prices, item mappings, 5-minute and 1-hour price averages, price time series for specific items, and RuneScape 3 hiscores for players. The server is designed to work with clients that support MCP tool calls and will respond with structured results for each tool invocation.

Use the provided client configuration to point your MCP tooling at the server. The server is designed to be run locally or on a host, and it exposes its functionality through a single executable entry point that you reference from your MCP client configuration.

How to install

Prerequisites you need before installing: nodejs 18.0.0 or higher and npm or yarn.

Step 1: Install dependencies

npm install

Step 2: Build the project

npm run build

Step 3: Run in development mode to enable auto-restart on file changes

npm run dev

Configuration and usage notes

Configure your MCP client to connect to the RS3 RuneScape Wiki MCP server. The example configuration below shows how to reference the local server instance via an MCP client like Claude Desktop.

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "node",
      "args": ["/path/to/runescape-wiki-mcp/dist/index.js"]
    }
  }
}

Operational tips

To test the server, you can run the inspector tool provided by the MCP ecosystem. This helps verify that the server responds correctly to tool calls and that you receive properly structured data.

For quick validation, you can run the test suite to ensure the server is wired correctly and responding as expected.

Available tools

get_latest_prices

Fetch the latest Grand Exchange prices for all items or a specific item by itemId.

get_item_mapping

Retrieve the complete item mapping including IDs, names, and metadata.

get_5m_prices

Obtain 5-minute average prices for all items, with an optional timestamp.

get_1h_prices

Obtain 1-hour average prices for all items, with an optional timestamp.

get_timeseries

Retrieve price time series data for a specific item with a defined timestep (5m, 1h, 6h, 24h).

get_player_stats

Lookup RuneScape 3 hiscores data for a given username and game mode.