Preface¶
When building agents that need to access domain-specific data (such as game leaderboards), direct integration with third-party APIs often requires handling complex authentication and data parsing logic. The plugin-based architecture of DeepSeek Harness (DSH) allows developers to encapsulate this kind of logic as MCP servers, making it directly callable in agent conversations. xby-osrs-stat is a data-service plugin provided for this purpose, specifically for Old School RuneScape.
Plugin Overview¶
xby-osrs-stat is a Model Context Protocol (MCP) server maintained by xby-skill. It provides real-time player statistics and leaderboard data for Old School RuneScape, supporting multiple game modes and player comparison features.
Core Features¶
- set_xby_apikey: Sets the API key during conversation. Once configured, it is persisted automatically and remains valid after restarting the process.
- get_player_stats: Retrieves comprehensive statistics for a specific
OSRSplayer. - get_skill_leaderboard: Retrieves the top players for a specific skill.
- get_activity_leaderboard: Retrieves activity leaderboards (Bosses, minigames, clue scrolls).
- compare_players: Compares the statistics of multiple
OSRSplayers.
Installation and Activation¶
Use the officially recommended installation command:
dsh plugin --profile web add github:xby_skill/xby-osrs-stat
Typical Usage¶
Before using the plugin, you need to obtain an API key. Visit the official Xiaobenyang website to register and obtain the key, then configure it by calling set_xby_apikey in the chat.
After configuration, you can use the following features:
* Retrieve comprehensive statistics for a specific OSRS player.
* Query the top players for a specific skill (such as Attack, Magic, etc.).
* Query activity leaderboards (Bosses, minigames, clue scrolls).
* Compare numerical statistics among multiple OSRS players.
Applicable Scenarios and Notes¶
This plugin is suitable for agent applications that need to integrate OSRS game data, build leaderboard features, or compare player data.
Note: The plugin runs with the permissions of the current DSH process. Please review the source code and license (MIT) before installation.
References¶
- Plugin directory: https://www.skillhub.cn/plugins/xby-skill/xby-osrs-stat
- GitHub repository: https://github.com/xby-skill/xby-osrs-stat