OSRS MCP Server

by JayArrowz

26 stars

233 downloads

Not rated

GitHub

Other

About

OSRS MCP Server is a Model Context Protocol server that provides tools to search the Old School RuneScape (OSRS) Wiki API and access game data definitions. It is intended for developers and players who want to integrate OSRS information into AI assistants or automated workflows.

Details

Author: JayArrowz
GitHub stars: 26
Downloads: 233
Categories: Other

- Search the OSRS Wiki for pages and parse their content
- Query game data files including varps, varbits, interfaces, and definitions
- Retrieve Grand Exchange item prices, limits, and historical data
- Look up any OSRS player's hiscore stats (skills, bosses, clues)
- List and search all available data files in the server

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name OSRS MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

From the repository

Install via Smithery with npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claude, or clone the repository, install dependencies with npm install, build with npm run build, and configure your MCP client with a command like npx -y @jayarrowz/mcp-osrs or a direct Node.js path. The server exposes 23 tools covering wiki search, game data file queries, Grand Exchange prices, and player lookup.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "osrs mcp server": {
            "mcp-osrs": {
                "command": "npx",
                "args": [
                    "@smithery/cli@latest",
                    "install",
                    "@jayarrowz/mcp-osrs",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-osrs": {
        "command": "npx",
        "args": [
            "@smithery/cli@latest",
            "install",
            "@jayarrowz/mcp-osrs",
            "--client",
            "claude"
        ]
    }
}

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

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

Generic Data File Methods

17. search_data_file - Search any file in the data directory for matching entries 18. get_file_details - Get details about a file in the data directory 19. list_data_files - List available data files in the data directory

Grand Exchange Prices

20. search_ge_items - Search for Grand Exchange tradeable items by name. Returns item IDs, names, buy limits, and alch values 21. get_ge_latest - Get the latest Grand Exchange high and low prices for a specific item by its ID 22. get_ge_timeseries - Get historical time-series price data for an item at a given interval (5m, 1h, 6h, 24h). Returns up to 365 data points

Player Lookup

23. lookup_player - Look up an OSRS player's stats (skills, bosses, clue scrolls, and activities) from the official hiscores

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

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

OSRS MCP Server

Tools

OSRS Wiki Methods

Game Data Search Methods

Generic Data File Methods

Grand Exchange Prices

Player Lookup

Installation

Installing via Smithery

Prerequisites

Installing the package

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀