mcp-server-runescape

@stefanerd

About mcp-server-runescape

MCP server with tools for interacting with RuneScape (RS) and Old School RuneScape (OSRS) data

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

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?"

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"

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?"

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"

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

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.

Overview

What is mcp-server-runescape?

mcp-server-runescape is an MCP server that provides tools for interacting with RuneScape (RS) and Old School RuneScape (OSRS) data, including item prices, player hiscores, and more. It is designed for players who want to query game data via AI assistants.

How to use mcp-server-runescape?

Install by adding the NPM package to your MCP client configuration (e.g., Claude desktop or Cursor) with npx -y mcp-server-runescape. Alternatively, clone the repository, run yarn or npm install, and point the config to the local server.js file. After updating the config, restart the client.