mcp-server-runescape

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.

Key features of mcp-server-runescape

• Retrieve tradeable item details (current price, trends, name, category)
• Access 180-day price history for items
• Fetch player hiscores (rank, level, experience, activity scores)
• View top 50 rankings per skill or activity
• Get real-time player counts for RS and OSRS
• Query total number of RuneScape accounts created

Use cases of mcp-server-runescape

• Checking current Grand Exchange prices while playing
• Analyzing price trends over days or months
• Looking up player ranks and experience (e.g., Zezima)
• Viewing top performers for specific skills or bosses
• Monitoring online player counts in real time

FAQ from mcp-server-runescape

What data sources does mcp-server-runescape use?

It uses the RuneScape Wiki API endpoints for item prices, player hiscores, and more.

What are the runtime requirements?

Node.js must be installed on your system to run the server.

Can I query both RuneScape and Old School RuneScape data?

Yes, the tools consistently support both RS and OSRS data.

How do I install mcp-server-runescape?

You can run it via npx (npx -y mcp-server-runescape) or clone the repository and install dependencies with yarn or npm.

Are there any usage limits?

The top rankings tool returns a maximum of 50 players per query. Item details only cover tradeable items.