RS3-MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
๐ฎ 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.
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:
๐ฐ get_item_details: Real-time Grand Exchange prices and 180-day trends.
๐ get_item_price_history: Historical data visualization for market analysis.
๐ get_player_hiscore: Deep-dive into player ranks, XP, and activity scores.
๐ฅ get_top_rankings: Skill-specific leaderboards and competitive analysis.
๐ฅ get_player_count: Real-time server population tracking.
๐ 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
AI Agent Utility Layer for agent safety, web monitoring, crypto research and tool discovery.
A registry of AI agent tools โ MCP servers, APIs, CLIs, SDKs โ kept current by automated ingestion.
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Give your agent live data from Twitter, Reddit, the web and GitHub. No API keys, no scraping stack.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.1354 npm2MIT
- FlicenseNot gradedqualityDmaintenanceProvides access to Old School RuneScape wiki information and game data through MCP tools. Enables users to query OSRS game content, items, and mechanics via natural language.1-
- FlicenseAqualityDmaintenanceExposes 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-
- AlicenseAqualityDmaintenanceEnables 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.1310 npm1BSD 2-Clause "Simplified"