Runescape Wiki Mcp

by birdwell

460 downloads
Not rated
GitHub

About

This MCP server provides AI assistants with real-time access to RuneScape 3 game data through the RuneScape Wiki APIs. It enables AI systems to retrieve current Grand Exchange prices, detailed item information (including stats, examine text, and alchemy values), historical price

Details

Author
birdwell
Downloads
460
Categories
Knowledge Base

- Real-time Grand Exchange prices (latest, 5m, 1h averages)
- Complete item database with IDs, names, and metadata
- Price time series data with configurable intervals
- Player statistics from RS3 hiscores for normal, ironman, and hardcore modes
- MCP resource URIs for prices and item mapping
- Comprehensive error handling and validation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Runescape Wiki Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js 18+, then run npm install and npm run build. The server can be started with npm start or in development mode with npm run dev. Configure it with Claude Desktop by adding the server path to your MCP settings, or test it using npm run inspector to launch the MCP Inspector. Tools like get_latest_prices and get_player_stats are invoked via MCP tool calls.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

RuneScape Wiki MCP Server

A Model Context Protocol (MCP) server that provides access to RuneScape Wiki APIs, including real-time Grand Exchange prices, item data, and player statistics for RuneScape 3 (RS3).

Features

- Real-time Grand Exchange Prices: Get current, 5-minute, and 1-hour average prices for all items
- Item Database: Access complete item mappings with metadata (names, IDs, examine text, etc.)
- Price Time Series: Historical price data with configurable time intervals
- Player Statistics: Lookup player stats from RuneScape 3 hiscores
- Multiple Game Modes: Support for normal, ironman, and hardcore ironman accounts
- MCP Resources: Direct access to price and item data through MCP resource URIs

Installation

Prerequisites

- Node.js 18.0.0 or higher
- npm or yarn

Install Dependencies

npm install

Build the Project

npm run build

Development Mode

npm run dev

This will start the TypeScript compiler in watch mode and automatically restart the server when files change.

Usage

With Claude Desktop

Add the following configuration to your Claude Desktop config file:

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

With MCP Inspector

Test the server using the MCP Inspector:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.