mcp -runescape

This MCP server provides a set of RuneScape (RS) and Old School RuneScape (OSRS) data tools. It exposes utilities to fetch item details, item price history, player hiscores, top rankings, current online player counts, and total RS/OSRS account creations. The available tools include:

• get_item_details: returns current Grand Exchange price, price trends (24h, 30, 90, 180 days), item name, category, description, image, membership, and ID.
• get_item_price_history: retrieves historical prices for an item over the last 180 days, including daily prices and daily averages.
• get_player_hiscore: fetches a player's rank, skill level, experience, and activity scores.
• get_top_rankings: lists the top up to 50 players for a given skill or activity, with name, score, and rank.
• get_player_count: reports real-time counts of players online in RS and OSRS.
• get_rsuser_total: provides the current total number of accounts that can access RuneScape (including FunOrb-era or other versions).

You can query these tools through your MCP client by addressing the server name mcp-server-runescape and calling the respective endpoints/commands defined by the MCP protocol. The README provides example prompts like “What is the price of a dragon scimitar in the Grand Exchange?” to fetch specific data, or “Top 10 players overall?” to retrieve rankings. The server is designed to support both RS and OSRS data where possible to maintain consistency across versions.

Prerequisites:

• Node.js installed on your system
• Access to a terminal/command prompt
• Git (optional for cloning the repository)

Install steps:

1. Clone the repository (replace with actual repo URL):

git clone https://github.com/user/mcp-server-runescape.git
cd mcp-server-runescape

2. Install dependencies (choose one):

yarn

or

npm install

3. Run the server in development mode (if provided):

yarn dev

or

npm run dev

4. Ensure your MCP client config points to the server, for example:

{
  "mcpServers": {
    "mcp-server-runescape": {
      "command": "node",
      "args": ["/path/to/mcp-server-runescape/src/server.js"]
    }
  }
}

5. Restart your MCP client after configuring the server. You can also use the npx-based startup as shown in the example configuration:

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

Notes and tips:

• This server aims to use data from RS/OSRS sources that support both versions for consistency across endpoints.
• If you encounter missing data for a specific item or user, verify the item ID or player name spelling. Some endpoints may require exact identifiers.
• Environment variables are not strictly required in the basic setup, but you may want to configure API keys or rate-limit settings depending on the data sources you rely on.
• When running locally, you can enable a debugger/inspector via the provided npm/yarn scripts (e.g., yarn dev) if available in the repository.
• For client configurations, ensure the path to the server.js (or equivalent) is correct when you choose to run the server directly via node.
• If you need to customize sources or endpoints, check the repository's API documentation and the Runescape Wiki endpoints referenced by the server.