Skip to main content
Glama
mcp-server-runescape

mcp-server-runescape

by stjepko-xyz

mcp-server-runescape

npm version

This is an MCP server with tools for interacting with RuneScape (RS) and Old School RuneScape (OSRS) data, including item prices, player hiscores, and more.

https://github.com/user-attachments/assets/7c141575-443b-4b76-8b33-6d48ec82fbe7

Features

The MCP server provides several tools which are used to answer your questions during gaming with data from accurate sources.

1. Item Details (get_item_details)

Retrieve comprehensive information about tradeable items, including:

  • Current price in the Grand Exchange

  • Price trends (24h, 30, 90, and 180 days)

  • Name

  • Category

  • Description (examine text)

  • Image

  • Members

  • ID

https://runescape.wiki/w/Application_programming_interface#detail

2. Item Price History (get_item_price_history)

Access the price history of an item over the last 180 days, including:

  • Price on a given day (timestamp)

  • Average price on a given day (timestamp)

https://runescape.wiki/w/Application_programming_interface#Graph

3. Player Hiscore (get_player_hiscore)

Fetch rankings and experience for skills and activities of any player, including:

  • Player rank

  • Skill level

  • Experience points

  • Activity scores

https://runescape.wiki/w/Application_programming_interface#Hiscores_Lite_2

4. Top Rankings (get_top_rankings)

View the top (max 50) players for a specific skill or activity, including:

  • Name

  • Score (used for both skill and activity)

  • Rank

https://runescape.wiki/w/Application_programming_interface#ranking

5. Player Count (get_player_count)

Gets the number of players currently online in RuneScape and Old School RuneScape, including:

  • Real-time player counts

https://runescape.wiki/w/Application_programming_interface#player_count

6. Account Totals (get_rsuser_total)

Gets the current amount of accounts created that can access any form of RuneScape. This includes accounts made on FunOrb or a particular version of RuneScape, including:

  • Historical accounts creation data

https://runescape.wiki/w/Application_programming_interface#rsusertotal

Note

For consistency I tried to only use API endpoints which support both RS and OSRS data.

Related MCP server: OSRS-STAT

Example Use Cases

The goal is for you to have an easy way to fetch more accurate data right from the source while scaping.

Here are some example queries you can ask the AI when using this MCP server:

Item Details

"What is the price of a dragon scimitar in the Grand Exchange?"
"Torva full helm price"
"Current price of a dragon pickaxe"
"How much percentage has the price of a dragon pickaxe changed in the past 30 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 90 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 180 days?"
"Give me the description of an armadyl godsword"
"Give me the icon of a dragon scimitar"
"What is the id of an abbyssal whip?"

Item Price History

"Give me the price history of a dragon scimitar"
"Rune scimitar price on 1 april 2025?"

Player Hiscore

"What rank is Zezima?"
"What rank is Zezima on runescape?"
"How much experience does Lynx Titan have overall?"
"Iron Hyger ironman rank?"

Top Rankings

"Top 10 players overall?"
"Give me the top 50 attack rankings"
"Number one agility on runescape?"
"Most zulrah kills?"
"Give me the top 5 jad rankings"

Getting Started

Introduction to MCP servers

You can use the MCP server in many clients, for example:

  • Claude desktop

  • Cursor

1. Add the MCP server in your config (NPM Package)

Paste this snippet in your mcp config that your client is using

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

You can find the config file in (mac):

  • Claude desktop:

~/Library/Application Support/Claude/claude_desktop_config.json

  • Cursor:

/Users/name/.cursor/mcp.json

2. From Source

Required Node.js installed on your system

  1. Clone this repository

  2. Install dependencies:

    yarn

    or

    npm install
  3. Then update your Claude desktop or Cursor with:

    {
      "mcpServers": {
        "mcp-server-runescape": {
          "command": "node",
          "args": ["/Users/path/to/mcp-server-runescape/src/server.js"]
        }
      }
    }
  4. Optional: Run the debugger/inspector

    yarn dev

    or

    npm run build

Make sure to:

  • Replace /path/to/mcp-server-runescape with the actual path to your installation.

After updating the configuration, restart Claude desktop or Cursor for the changes to take effect.

Personal preference

You can use any client you want, my personal preference goes to Cursor at the moment in combination with deepseek-v3.1 which is performing really well.

List of clients

API Documentation

For detailed information about the Runescape API endpoints used by this MCP server, visit: RS/Wiki API

Thank you

I built this over the weekend, to learn a bit more about MCP servers. Runescape was the perfect subject to try it out on.

  • Shout out to the rs/wiki team for the docs and API.

If this helps you out in anyway when scaping and you would like to support me, feel free to

"Buy Me A Coffee"

Available Tools

6 tools
get_item_detailsA
Returns the current price and price trends information on tradeable items in the Grand Exchange, the category, item image and examine for the given item.
Examples: 
- Single: "What is the price of a dragon scimitar?"
- Multi comparison: "Compare the price of a dragon scimitar and a rune scimitar"     
- "Torva full helm price" 
- "Current price of a dragon pickaxe"
- "How much percentage has the price of a dragon pickaxe changed in the past 30 days?"
- "How much percentage has the price of a dragon pickaxe changed in the past 90 days?"
- "How much percentage has the price of a dragon pickaxe changed in the past 180 days?"
- "Give me the description of an armadyl godsword"
- "Give me the icon of a dragon scimitar"
- "What is the id of an abyssal whip?"    

Inputs: gameMode (required), itemName (required).

get_item_price_historyA
Returns the prices each day of a given item for the previous 180 days. This is useful for seeing the price trends of an item over time. Usefull for when someone asks all price history of an item.
Examples:
- Single: "Price history of a dragon scimitar?"
- Multi comparison: "Compare all price history of a dragon scimitar and a rune scimitar"
- "All prices for a dragon scimitar"
- "Rune scimitar price on 1 april 2025"  

Inputs: gameMode (required), itemName (required).

get_player_countA

Returns the number of players currently online in RuneScape and Old School RuneScape.

get_player_hiscoreB
Returns a player's rank, level and experience or score in an activity.
Examples:
- Single: "What rank is Zezima?"
- Multi comparison: "Compare Zezima and Lynx Titan"
- "What rank is Zezima on runescape?"
- "How much experience does Lynx Titan have overall?"
- "Iron Hyger ironman?"

Inputs: gameMode (required), playerName (required), type.

get_rsuser_totalA

Returns the current amount of accounts created that can access any form of RuneScape. This includes accounts made on FunOrb or a particular version of RuneScape.

get_top_rankingsA
Returns up to the top 50 players in a given skill or activity.
Examples:
- Single: "Top 10 players overall?"
- Multi comparison: "Compare the top 10 defence and attack rankings"
- "Give me the top 50 attack rankings"
- "Number one agility on runescape?"
- "Most zulrah kills?"
- "Give me the top 5 jad rankings"

Inputs: name (required), gameMode (required), size.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation4/5

    Tools are mostly distinct, but get_item_details and get_item_price_history both deal with item prices, which could cause confusion. The descriptions clarify that one provides current price/trends and the other historical daily prices, so a clear boundary exists.

    Naming Consistency5/5

    All tools follow a consistent get_<resource>_<detail> pattern, e.g., get_item_details, get_player_hiscore, get_top_rankings. This makes the tool set predictable and easy to navigate.

    Tool Count5/5

    With 6 tools, the server is well-scoped for RuneScape data covering items, players, and server statistics. Each tool serves a core purpose without unnecessary bloat.

    Completeness4/5

    The set covers item price details/history, player hiscore data, top rankings, and server status, which forms a solid foundation. Minor gaps exist, such as no direct item search by partial name or separate OSRS/RS3 filtering, but these are workable.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      MCP Server for interacting with Old School RuneScape Wiki API and game data files, providing tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.
      2
      19
      90 npm
      1
      -
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides real-time player statistics and ranking data of 'Old School RuneScape', supporting multiple game modes and player comparison functions.
      4
      2
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server wrapping the Wise Old Man OSRS stat-tracking API, exposing 54 tools for players, groups, competitions, records, deltas, name changes, and efficiency (EHP/EHB) for MCP-compatible clients.
      54
      ISC