mcp-server-runescape
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-runescape What's the price of a dragon scimitar?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
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
Clone this repository
Install dependencies:
yarnor
npm installThen update your Claude desktop or Cursor with:
{ "mcpServers": { "mcp-server-runescape": { "command": "node", "args": ["/Users/path/to/mcp-server-runescape/src/server.js"] } } }Optional: Run the debugger/inspector
yarn devor
npm run build
Make sure to:
Replace
/path/to/mcp-server-runescapewith 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.
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

Available Tools
6 toolsget_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
Publish and discover MCP servers via the official MCP Registry. Powered by HAPI MCP server.
Public MCP server for discovering open jobs. Search, filter, and get application links.
The official MCP Server for the Mux API
Related MCP Servers
AlicenseBqualityNot gradedmaintenanceMCP 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.21990 npm1-- AlicenseBqualityDmaintenanceA 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.42Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for the Old School RuneScape Wiki, game data, Grand Exchange prices, and hiscores with polite client behavior.6 npmMIT
- AlicenseAqualityDmaintenanceMCP 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.54ISC