Skip to main content
Glama

mcp-server-runescape

๐ŸŽฎ RS3-MCP - Professional RuneScape Automation Server

A production-ready implementation of the Model Context Protocol (MCP), providing AI agents (like Claude and ChatGPT) with high-fidelity tools to interact with the RuneScape 3 and OSRS ecosystems.

NOTE

This project is forked and significantly enhanced fromstefanxyz/mcp-server-runescape.

๐Ÿš€ Enhancements & Modernization

While the core API interactions were established by stefanxyz, this repository features comprehensive enterprise-grade improvements:

  • ๐Ÿ›ก๏ธ Full Validation Suite: Includes a rigorous automated testing framework (Vitest) for API stability.

  • ๐Ÿ›ก๏ธ Error Resilience: Enhanced error handling and fallback logic for unreliable RuneScape endpoints.

  • ๐Ÿ›ก๏ธ Performance Audit: Detailed benchmarking and optimization reports for low-latency tool execution.

  • ๐Ÿ›ก๏ธ Agentic Integration: Specific optimizations for "Cursor" and "Claude Desktop" environments.

Related MCP server: Wiki OSRS MCP

โœจ Core Tools

The server provides 6 essential tools for AI-driven gameplay analysis:

  1. ๐Ÿ’ฐ get_item_details: Real-time Grand Exchange prices and 180-day trends.

  2. ๐Ÿ“ˆ get_item_price_history: Historical data visualization for market analysis.

  3. ๐Ÿ† get_player_hiscore: Deep-dive into player ranks, XP, and activity scores.

  4. ๐Ÿฅ‡ get_top_rankings: Skill-specific leaderboards and competitive analysis.

  5. ๐Ÿ‘ฅ get_player_count: Real-time server population tracking.

  6. ๐Ÿ“‹ get_rsuser_total: Global account creation and historical growth metrics.

๐Ÿ“ฆ Getting Started

1. Requirements

  • Node.js 18+

  • MCP Client (Claude Desktop, Cursor, etc.)

2. Configuration (Claude Desktop)

Paste this into your claude_desktop_config.json:

{
  "mcpServers": {
    "rs3-mcp": {
      "command": "node",
      "args": ["F:/Software Developement/Portfolio/Games/rs3bot/mcp-server-runescape/src/server.js"]
    }
  }
}

๐Ÿ› ๏ธ Testing & Validation

We maintain a detailed log of system health:

  • API_VALIDATION_REPORT.md: Comprehensive endpoint status.

  • PERFORMANCE_OPTIMIZATION_SUMMARY.md: Latency benchmarks.

  • MCP_CONNECTION_VALIDATION_SUMMARY.md: Client-side handshake verification.

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details. Original core logic ยฉ 2025 stefanxyz. Enhancements and validation suite ยฉ 2026 Ross Ward.


Developed & Validated by Ross Ward ๐Ÿ“ก๐Ÿ›ฐ๏ธ๐ŸŒŽ

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables access to RuneScape 3 data, including real-time Grand Exchange prices, item information, historical price trends, and player statistics. Supports multiple game modes and provides comprehensive RuneScape Wiki API integration through natural language.
      13
      54 npm
      2
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Exposes Old School RuneScape account data (quests, skills, diaries, etc.) via WikiSync and official HiScores, allowing Claude to query player progress without manual copy-pasting.
      2
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search the OSRS Wiki, lookup Grand Exchange prices, and access synced player data (bank, skills, quests, etc.) via local RuneLite plugin files.
      13
      10 npm
      1
      BSD 2-Clause "Simplified"