mcp-server-runescape

What is mcp-server-runescape?

mcp-server-runescape is an MCP server that provides tools for fetching RuneScape (RS) and Old School RuneScape (OSRS) data, including item prices, player hiscores, and more. It is built for use with MCP-compatible clients like Claude desktop and Cursor.

How to use mcp-server-runescape?

Install via npm by running npx -y mcp-server-runescape, or clone the repository and run npm install/yarn. Add the server configuration to your MCP client’s config file (e.g., claude_desktop_config.json or .cursor/mcp.json) using either the npx command or a local path to server.js. Restart the client to apply changes.

Key features of mcp-server-runescape

• Fetch Grand Exchange item details and current prices
• Retrieve 180‑day price history for items
• Look up player hiscores (rank, level, experience)
• View top 50 rankings for any skill or activity
• Get real‑time player counts for RS and OSRS
• Obtain historical account creation totals

Use cases of mcp-server-runescape

• Ask an AI assistant for the current price of a RuneScape item
• Check a player’s rank and experience for a specific skill
• View the top 10 players worldwide in a given activity
• Analyze price trends for items over the past 180 days
• Monitor how many players are online in real time

FAQ from mcp-server-runescape

What tools does the server provide?

It provides six tools: get_item_details, get_item_price_history, get_player_hiscore, get_top_rankings, get_player_count, and get_rsuser_total.

How do I install mcp-server-runescape?

You can run it via npx -y mcp-server-runescape or clone the repository, install dependencies with npm install or yarn, then configure your MCP client with the appropriate command.

What data sources does it use?

It uses the RuneScape Wiki API (runescape.wiki/w/Application_programming_interface), preferring endpoints that support both RS and OSRS data.

Does it require Node.js?

Yes, Node.js must be installed on your system.

Which MCP clients are supported?

The README explicitly mentions Claude desktop and Cursor, but other MCP clients may also work. Transport is assumed to be stdio (standard MCP server pattern). No authentication is required.