Skip to main content
Glama
Sign In
enesjakozh

OSRS MCP Server

by JayArrowz
npmGitHub
JavaScript
MIT License
136
3
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. osrs_wiki_search - Search the OSRS Wiki for pages matching a search term
  2. osrs_wiki_get_page_info - Get information about specific pages on the OSRS Wiki
  3. osrs_wiki_parse_page - Get the parsed HTML content of a specific OSRS Wiki page

Game Data Search Methods

  1. search_varptypes - Search the varptypes.txt file for player variables (varps) that store player state and progress
  2. search_varbittypes - Search the varbittypes.txt file for variable bits (varbits) that store individual bits from varps
  3. search_iftypes - Search the iftypes.txt file for interface definitions used in the game's UI
  4. search_invtypes - Search the invtypes.txt file for inventory type definitions in the game
  5. search_loctypes - Search the loctypes.txt file for location/object type definitions in the game world
  6. search_npctypes - Search the npctypes.txt file for NPC (non-player character) definitions
  7. search_objtypes - Search the objtypes.txt file for object/item definitions in the game
  8. search_rowtypes - Search the rowtypes.txt file for row definitions used in various interfaces
  9. search_seqtypes - Search the seqtypes.txt file for animation sequence definitions
  10. search_soundtypes - Search the soundtypes.txt file for sound effect definitions in the game
  11. search_spottypes - Search the spottypes.txt file for spot animation (graphical effect) definitions
  12. search_spritetypes - Search the spritetypes.txt file for sprite image definitions used in the interface
  13. search_tabletypes - Search the tabletypes.txt file for interface tab definitions

Generic Data File Methods

  1. search_data_file - Search any file in the data directory for matching entries
  2. get_file_details - Get details about a file in the data directory
  3. 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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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.

  1. Tools
    1. OSRS Wiki Methods
    2. Game Data Search Methods
    3. Generic Data File Methods
  2. Installation
    1. Installing via Smithery
    2. Prerequisites
    3. Installing the package
  3. Usage with Claude Desktop
    1. Using npx
    2. Direct Node.js
  4. Examples
    1. Search the OSRS Wiki
    2. Get Page Information
    3. Search Game Data
    4. List Available Data Files
  5. Development
    1. License

      Related MCP Servers

      • Zotero MCP Server

        kujenga
        A
        security
        A
        license
        A
        quality
        This server allows users to interact with their Zotero library through the Model Context Protocol, providing tools for searching items, retrieving metadata, and accessing full text using natural language queries.
        Last updated -
        3
        44
        Python
        MIT License
        • Apple
        • Linux

      • OpenDota MCP Server

        asusevski
        -
        security
        F
        license
        -
        quality
        Model Context Protocol server that enables LLMs and AI assistants to retrieve real-time Dota 2 statistics, match data, player information, and game metrics through a standardized interface.
        Last updated -
        4
        Python
        • Linux

      • OneSearch MCP Server

        yokingma
        -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.
        Last updated -
        35
        11
        TypeScript
        MIT License

      • MCP Riot Server

        jifrozen0110
        -
        security
        A
        license
        -
        quality
        A community-developed Model Context Protocol server that integrates with the Riot Games API to provide League of Legends data, enabling AI assistants to retrieve player information, ranked stats, champion mastery, and match summaries through natural language queries.
        Last updated -
        3
        Python
        MIT License
        • Apple

      View all related MCP servers

      ID: ctkzx8ysig