OSRS Wiki

This is an MCP server for interacting with the Old School RuneScape (OSRS) wiki API and data files, providing game data query and wiki search functions.

Games and gamification Developer tools #Game data #Wiki search #OSRS tools Local .TypeScript

rating : 2.5 points

downloads : 22

update time : 2025-04-28

What is the OSRS MCP Server?

The OSRS MCP Server is a Model Context Protocol server specifically designed for the Old School RuneScape game. It allows users to query game data and access OSRS wiki content through a standardized interface without delving into the underlying technical details of the game.

How to use the OSRS MCP Server?

You can use this service through simple API calls or by configuring Claude Desktop. The server provides various tools to search for game data and wiki content, including detailed information queries for various game elements such as items, NPCs, and animations.

Applicable scenarios

Suitable for OSRS players, data enthusiasts, Wiki editors, and game developers. It can be used to quickly find game information, build game databases, develop auxiliary tools, or conduct game data analysis.

Main features

OSRS Wiki SearchProvides three wiki search tools: basic search, page information retrieval, and page content parsing

Game data querySupports querying 12 different types of game data files, including items, NPCs, animations, sound effects, etc.

General data file operationsProvides functions for data file search, detail retrieval, and list viewing

Advantages and limitations

Advantages

Obtain OSRS game data and wiki content in one stop

The standardized interface is easy to integrate into various applications

Supports querying multiple game data types

Open - source and allows for custom extensions

Limitations

Basic technical knowledge is required for configuration

Data updates depend on upstream data sources

Some advanced features may require additional development

How to use

Installation

Can be installed automatically via Smithery or manually

Configure Claude Desktop

Add the MCP server configuration to claude_desktop_config.json

Use tools

Call various tool methods through the callTool function to query data

Usage examples

Find item informationQuery detailed information about the 'Abyssal whip' item in the game

Search for dragon - type NPCsFind all NPCs in the game whose names contain 'dragon'

Frequently Asked Questions

What technical prerequisites are required to use this service?

How often is the data updated?

Can the functions be customized or extended?

Related resources

Project GitHub repository

Source code and latest version

Smithery platform

One - click installation service

OSRS Wiki

Official game wiki

🚀 OSRS MCP Server

The OSRS MCP Server is designed to interact with the Old School RuneScape (OSRS) Wiki API and data files. It offers tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.

🚀 Quick Start

The OSRS MCP Server provides a set of tools to interact with the OSRS Wiki and game data files. You can use these tools to search for information and access game data definitions.

✨ Features

OSRS Wiki Methods

osrs_wiki_search - Search the OSRS Wiki for pages matching a given search term.
osrs_wiki_get_page_info - Get information about a specific OSRS Wiki page.
osrs_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 variables (varps) that store player state and progress.
search_varbittypes - Search the varbittypes.txt file for individual bits (varbits) from varps.
search_iftypes - Search the iftypes.txt file for game interface definitions.
search_invtypes - Search the invtypes.txt file for inventory type definitions in the game.
search_loctypes - Search the loctypes.txt file for location/object type definitions in the game world.
search_npctypes - Search the npctypes.txt file for non-player character (NPC) definitions.
search_objtypes - Search the objtypes.txt file for object/item definitions in the game.
search_rowtypes - Search the rowtypes.txt file for row definitions used in various interfaces.
search_seqtypes - Search the seqtypes.txt file for animation sequence definitions.
search_soundtypes - Search the soundtypes.txt file for sound effect definitions in the game.
search_spottypes - Search the spottypes.txt file for graphical effect (spot animation) definitions.
search_sprotypes - Search the srotypes.txt file for a certain type of definition (Note: There might be an error in the original text here, possibly srotypes or other relevant terms).
search_listtypes - Search the listtypes.txt file for list type definitions.

Other Tools

list_data_files - Get a list of all available data files.

📦 Installation

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

📄 License

This MCP Server is released 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 refer to the LICENSE file in the project repository.