stefan-xyz/mcp-server-runescape

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.
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
Item Price History
Player Hiscore
Top 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
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