Skip to main content
Glama

RuneScape Wiki MCP Server

by birdwell

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:

# Using npm script (recommended) npm run inspector # Or manually with npx npx @modelcontextprotocol/inspector node dist/index.js

Quick Test

Verify the server is working correctly:

npm test

Available Tools

get_latest_prices

Get the latest Grand Exchange prices for all items or a specific item.

Parameters:

  • itemId (optional): Item ID to get price for specific item

Example:

{ "itemId": 4151 }

get_item_mapping

Get the complete mapping of all items with their IDs, names, and metadata.

Parameters: None

Returns: Array of items with:

  • id: Item ID

  • name: Item name

  • examine: Examine text

  • members: Whether it's a members-only item

  • lowalch: Low alchemy value

  • highalch: High alchemy value

  • limit: Grand Exchange buy limit

  • value: Item value

  • icon: Icon filename

get_5m_prices

Get 5-minute average prices for all items.

Parameters:

  • timestamp (optional): Unix timestamp to get prices for specific time

get_1h_prices

Get 1-hour average prices for all items.

Parameters:

  • timestamp (optional): Unix timestamp to get prices for specific time

get_timeseries

Get price time series data for a specific item.

Parameters:

  • itemId (required): Item ID to get time series for

  • timestep (required): Time interval - one of: 5m, 1h, 6h, 24h

Example:

{ "itemId": 4151, "timestep": "1h" }

get_player_stats

Get player statistics from RuneScape 3 hiscores.

Parameters:

  • username (required): Player username to lookup

  • gameMode (optional): Game mode - one of: normal, ironman, hardcore

Example:

{ "username": "Zezima", "gameMode": "normal" }

Returns: Parsed statistics including:

  • Overall rank and total level

  • Individual skill levels, experience, and ranks

  • Formatted data for all 30 skills (including Summoning, Dungeoneering, Divination, Invention, Archaeology, and Necromancy)

Item Category Mapping

Category Name

Category Number

Ammo

1

Arrows

2

Bolts

3

Construction materials

4

Cooking ingredients

5

Costumes

6

Crafting materials

7

Familiars

8

Fletching materials

9

Food and Drink

10

Herblore materials

11

Hunting equipment

12

Jewellery

13

Mage armour

14

Mage weapons

15

Melee armour - low

16

Melee armour - mid

17

Melee armour - high

18

Melee weapons - low

19

Melee weapons - mid

20

Melee weapons - high

21

Mining and Smithing

22

Potions

23

Prayer armour

24

Prayer materials

25

Range armour

26

Range weapons

27

Runecrafting

28

Runes, Spells, Teleports

29

Seeds

30

Summoning scrolls

31

Tools and containers

32

Woodcutting product

33

Pocket items

34

Stone spirits

35

Firemaking products

36

Archaeology materials

37-43

Refer to this table when using tools that require a category number, such as search_items.

Available Resources

runescape://prices/latest

Direct access to the latest Grand Exchange prices for all items.

runescape://items/mapping

Direct access to the complete item mapping data.

API Endpoints

This server uses the following RuneScape Wiki APIs:

  • RS3 Prices API: https://prices.runescape.wiki/api/v1/rs

    • Latest prices, 5-minute averages, 1-hour averages, time series data

  • RS3 Hiscores API: https://secure.runescape.com/m=hiscore

    • Player statistics for different game modes

Rate Limits

The RuneScape Wiki APIs have the following guidelines:

  • Use a descriptive User-Agent (automatically handled by this server)

  • Avoid excessive requests that could impact API stability

  • The server implements proper error handling and respects API limitations

Error Handling

The server includes comprehensive error handling:

  • API request failures are caught and returned as error responses

  • Invalid parameters are validated before making API calls

  • Network timeouts and connection issues are handled gracefully

  • Player not found errors are properly reported

Development

Project Structure

src/ ├── index.ts # Main server implementation ├── types/ # TypeScript type definitions └── utils/ # Utility functions dist/ # Compiled JavaScript output

Scripts

  • npm run build: Compile TypeScript to JavaScript

  • npm run watch: Watch for changes and recompile

  • npm start: Start the server in production mode

  • npm run dev: Start in development mode with auto-restart

  • npm test: Run a simple test to verify the server is working

  • npm run inspector: Launch the MCP Inspector to test the server

Adding New Tools

  1. Define the tool in the tools array with proper schema

  2. Add a case handler in the CallToolRequestSchema handler

  3. Implement the API logic with proper error handling

  4. Update this README with documentation

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

License

MIT License - see LICENSE file for details.

Acknowledgments

Support

For issues, questions, or feature requests, please open an issue on the GitHub repository.


Note: This is an unofficial tool and is not affiliated with Jagex or the RuneScape Wiki. Please respect the API usage guidelines and terms of service.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables access to RuneScape 3 data including real-time Grand Exchange prices, item information, historical price trends, and player statistics. Supports multiple game modes and provides comprehensive RuneScape Wiki API integration through natural language.

  1. Features
    1. Installation
      1. Prerequisites
      2. Install Dependencies
      3. Build the Project
      4. Development Mode
    2. Usage
      1. With Claude Desktop
      2. With MCP Inspector
      3. Quick Test
    3. Available Tools
      1. get_latest_prices
      2. get_item_mapping
      3. get_5m_prices
      4. get_1h_prices
      5. get_timeseries
      6. get_player_stats
    4. Item Category Mapping
      1. Available Resources
        1. runescape://prices/latest
        2. runescape://items/mapping
      2. API Endpoints
        1. Rate Limits
          1. Error Handling
            1. Development
              1. Project Structure
              2. Scripts
              3. Adding New Tools
            2. Contributing
              1. License
                1. Acknowledgments
                  1. Support

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      Provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
                      Last updated -
                      7
                      54
                      MIT License
                      • Apple
                    • A
                      security
                      F
                      license
                      A
                      quality
                      Provides real-time cryptocurrency price data from OKX exchange through a Model Context Protocol interface, allowing access to historical candlestick data and current market prices for any trading instrument.
                      Last updated -
                      2
                      4
                      14
                      • Apple
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A server that provides tools for retrieving real-time price information for various assets including precious metals and cryptocurrencies, allowing language models to access and display current asset price data.
                      Last updated -
                      1
                      42
                      2
                      MIT License
                      • Apple
                      • Linux
                    • A
                      security
                      A
                      license
                      A
                      quality
                      Enables interaction with Old School RuneScape game data and Wiki through the Model Context Protocol, providing tools to search the OSRS Wiki and access game definitions for items, NPCs, locations, and game mechanics.
                      Last updated -
                      19
                      30
                      10
                      MIT License
                      • Apple
                      • Linux

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/birdwell/runescape-wiki-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server