OSRS MCP Server
MCP Server for interacting with the Old School RuneScape (OSRS) Wiki API and data files. This server provides tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.
Tools
This server implements the following tools:
OSRS Wiki Methods
osrs_wiki_search
- Search the OSRS Wiki for pages matching a search termosrs_wiki_get_page_info
- Get information about specific pages on the OSRS Wikiosrs_wiki_parse_page
- Get the parsed HTML content of a specific OSRS Wiki page
Game Data Search Methods
search_varptypes
- Search the varptypes.txt file for player variables (varps) that store player state and progresssearch_varbittypes
- Search the varbittypes.txt file for variable bits (varbits) that store individual bits from varpssearch_iftypes
- Search the iftypes.txt file for interface definitions used in the game's UIsearch_invtypes
- Search the invtypes.txt file for inventory type definitions in the gamesearch_loctypes
- Search the loctypes.txt file for location/object type definitions in the game worldsearch_npctypes
- Search the npctypes.txt file for NPC (non-player character) definitionssearch_objtypes
- Search the objtypes.txt file for object/item definitions in the gamesearch_rowtypes
- Search the rowtypes.txt file for row definitions used in various interfacessearch_seqtypes
- Search the seqtypes.txt file for animation sequence definitionssearch_soundtypes
- Search the soundtypes.txt file for sound effect definitions in the gamesearch_spottypes
- Search the spottypes.txt file for spot animation (graphical effect) definitionssearch_spritetypes
- Search the spritetypes.txt file for sprite image definitions used in the interfacesearch_tabletypes
- Search the tabletypes.txt file for interface tab definitions
Generic Data File Methods
search_data_file
- Search any file in the data directory for matching entriesget_file_details
- Get details about a file in the data directorylist_data_files
- List available data files in the data directory
Installation
Installing via Smithery
To install mcp-osrs for Claude Desktop automatically via Smithery:
Prerequisites
- Node.js (v16 or later)
- npm or yarn
Installing the package
Usage with Claude Desktop
Add the following to your claude_desktop_config.json
:
Using npx
Direct Node.js
Replace /path/to/mcp-osrs
with the actual path to your repository.
Examples
Search the OSRS Wiki
Get Page Information
Search Game Data
List Available Data Files
Development
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
MCP Server for interacting with Old School RuneScape Wiki API and game data files, providing tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.
Related Resources
Related MCP Servers
- -securityAlicense-qualityMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.Last updated -43TypeScriptMIT License
- -securityAlicense-qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.Last updated -132TypeScriptMIT License
- -securityFlicense-qualityMCP server for the Clash of Clans API. Can get player, clan information, analyze ongoing wars, as well as war logs (provided they are public).Last updated -3JavaScript
- -securityFlicense-qualityAn MCP server that enables interaction with Markdown knowledge bases, allowing users to search and retrieve content by tags, text, URL, or date range from their local markdown files.Last updated -3Python