# stefan-xyz/mcp-server-runescape [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/stefan-xyz/mcp-server-runescape  
**GitHub Stars:** 13  
**npm Downloads (last month):** 76  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/stefan-xyz-mcp-server-runescape

## Description
An MCP server with tools for interacting with RuneScape (RS) and Old School RuneScape (OSRS) data, including item prices, player hiscores, and more.

## Tools
Capabilities this server exposes over MCP:

- **get_item_details** — 
    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?"    
    
- **get_item_price_history** — 
    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"  
    
- **get_player_hiscore** — 
    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?"
  
- **get_top_rankings** — 
    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"
  
- **get_player_count** — Returns the number of players currently online in RuneScape and Old School RuneScape.
- **get_rsuser_total** — 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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What stefan-xyz/mcp-server-runescape MCP server does

The stefan-xyz/mcp-server-runescape MCP server connects an MCP client to RuneScape and Old School RuneScape data. Its tools cover Grand Exchange items, price history, player hiscores, skill and activity rankings, current online population, and total accounts that can access RuneScape services.

The server is intended for information lookup rather than game control. It does not provide tools for playing the game, placing trades, changing accounts, or performing other in-game actions. The README says the implementation favors API endpoints that support both RuneScape and OSRS data.

## How it works

An MCP-compatible client sends natural-language requests to the exposed tools. The server obtains data from RuneScape Wiki API endpoints and returns structured results for the client to use in its response.

Item lookups can include the current Grand Exchange price, price movement over 24 hours and 30, 90, or 180 days, item name, category, examine text, image, membership status, and ID. Historical price queries cover daily prices and averages for the previous 180 days. Player and ranking requests return values such as names, ranks, levels, experience, and activity scores.

## Setup and configuration

The package can be run through `npx` using the following MCP configuration:

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

The README identifies Claude Desktop and Cursor as supported examples. After adding the server to a client configuration, restart the client so it loads the new MCP process. A source-based setup is also documented: install Node.js, clone the repository, install dependencies with `yarn` or `npm install`, and configure Node to run `src/server.js`. Source configuration requires replacing the example path with the actual local repository path.

## Tools and capabilities

- `get_item_details` looks up tradeable items, including current price, trends, category, description, image, membership status, and ID.
- `get_item_price_history` returns daily item prices and averages for the last 180 days.
- `get_player_hiscore` retrieves a player’s rank, skill level, experience, or activity score.
- `get_top_rankings` returns up to 50 players for a selected skill or activity, with names, scores, and ranks.
- `get_player_count` reports the current number of online players in RuneScape and OSRS.
- `get_rsuser_total` reports the current total of accounts able to access any RuneScape form, including accounts associated with FunOrb or particular RuneScape versions.

## Limitations and notes

The stefan-xyz/mcp-server-runescape MCP server relies on the availability and coverage of the RuneScape Wiki API endpoints. Price history is limited to the previous 180 days according to the documented tool behavior. Item details apply to tradeable Grand Exchange items. No API key, OAuth flow, or other credential requirement is documented in the supplied material.

The repository also mentions an optional debugger or inspector workflow through its development scripts, but that is separate from running the MCP server for normal client use.

_Full upstream README: https://allmcps.com/mcp/stefan-xyz-mcp-server-runescape/readme_