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 term
osrs_wiki_get_page_info - Get information about specific pages on the OSRS Wiki
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 player variables (varps) that store player state and progress
search_varbittypes - Search the varbittypes.txt file for variable bits (varbits) that store individual bits from varps
search_iftypes - Search the iftypes.txt file for interface definitions used in the game's UI
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 NPC (non-player character) 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 spot animation (graphical effect) definitions
search_spritetypes - Search the spritetypes.txt file for sprite image definitions used in the interface
search_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 entries
get_file_details - Get details about a file in the data directory
list_data_files - List available data files in the data directory

Installation

Installing via Smithery

To install mcp-osrs for Claude Desktop automatically via Smithery:

npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claude

Prerequisites

Node.js (v16 or later)
npm or yarn

Installing the package

# Clone the repository
git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs

# Install dependencies
npm install

# Build the package
npm run build

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Using npx

{
  "mcpServers": {
    "osrs": {
      "command": "npx",
      "args": ["-y", "@jayarrowz/mcp-osrs"]
    }
  }
}

Direct Node.js

{
  "mcpServers": {
    "osrs": {
      "command": "node",
      "args": ["/path/to/mcp-osrs/dist/index.js"]
    }
  }
}

Replace /path/to/mcp-osrs with the actual path to your repository.

Examples

Search the OSRS Wiki

// Search for information about the Abyssal whip
const result = await callTool("osrs_wiki_search", { 
  search: "Abyssal whip" 
});

Get Page Information

// Get information about a specific wiki page
const pageInfo = await callTool("osrs_wiki_get_page_info", { 
  titles: "Abyssal_whip" 
});

Search Game Data

// Search for items in the object definitions
const items = await callTool("search_objtypes", { 
  query: "dragon",
  page: 1,
  pageSize: 10
});

List Available Data Files

// Get a list of all data files
const files = await callTool("list_data_files", {});

Development

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

View all tools

Enables interaction with Old School RuneScape game data and Wiki through the Model Context Protocol, providing tools to search the OSRS Wiki and access game definitions for items, NPCs, locations, and game mechanics.

Related MCP Servers

ESA MCP Server
d-kimuson
A
security
A
license
A
quality
Enables interaction with esa.io's API through the Model Context Protocol, supporting article search and retrieval with a compliant MCP interface.
Last updated -
3
711
32
TypeScript
MIT License
MCP Server for OpenMetadata
yangkyeongmo
A
security
A
license
A
quality
Enables integration with OpenMetadata by wrapping its REST API for standardized interaction through the Model Context Protocol.
Last updated -
6
11
Python
MIT License
MCP RSS Server
xrusjohn
-
security
A
license
-
quality
A Model Context Protocol server that allows interaction with RSS feeds, enabling users to import subscriptions via OPML files, fetch and update articles automatically, and filter content by source and status.
Last updated -
33
JavaScript
MIT License
D&D MCP Server
study-flamingo
A
security
F
license
A
quality
A comprehensive Model Context Protocol server for managing Dungeons & Dragons campaigns with tools for characters, NPCs, locations, quests, combat encounters, and session tracking.
Last updated -
29
Python

View all related MCP servers

OSRS MCP Server

OSRS MCP Server

Tools

OSRS Wiki Methods

Game Data Search Methods

Generic Data File Methods

Installation

Installing via Smithery

Prerequisites

Installing the package

Usage with Claude Desktop

Using npx

Direct Node.js

Examples

Search the OSRS Wiki

Get Page Information

Search Game Data

List Available Data Files

Development

License

Tools

Related MCP Servers

ESA MCP Server

MCP Server for OpenMetadata

MCP RSS Server

D&D MCP Server

New MCP Servers

MCP directory API