Osrs Wiki
MCP server for Old School RuneScape Wiki API
Ask AI about Osrs Wiki
Powered by Claude Β· Grounded in docs
I know everything about Osrs Wiki. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
OSRS MCP Server
Forked from JayArrowz/mcp-osrs
MCP Server for interacting with the Old School RuneScape (OSRS) Wiki API and game data files through the Model Context Protocol.
Changes from upstream
- Wiki pages converted to clean markdown β Wiki page content is fetched as HTML and converted to readable markdown using Turndown, with aggressive stripping of images, navboxes, edit links, table of contents, and other wiki chrome. The original upstream returns raw HTML.
- Search result snippets cleaned β HTML tags are stripped from wiki search result snippets so they're readable in plain text.
- NPC & object spawn locations β Two new tools to look up world coordinates where NPCs and game objects spawn, sourced from the OSRS game cache with optional plane filtering and pagination.
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 content of a specific OSRS Wiki page as clean markdown
Game Data Search Methods
search_varptypes- Search for player variables (varps) that store player state and progresssearch_varbittypes- Search for variable bits (varbits) that store individual bits from varpssearch_iftypes- Search for interface definitions used in the game's UIsearch_invtypes- Search for inventory type definitions in the gamesearch_loctypes- Search for location/object type definitions in the game worldsearch_npctypes- Search for NPC (non-player character) definitionssearch_objtypes- Search for object/item definitions in the gamesearch_rowtypes- Search for row definitions used in various interfacessearch_seqtypes- Search for animation sequence definitionssearch_soundtypes- Search for sound effect definitions in the gamesearch_spottypes- Search for spot animation (graphical effect) definitionssearch_spritetypes- Search for sprite image definitions used in the interfacesearch_tabletypes- Search for interface tab definitions
Spawn Location Methods
get_npc_spawn_locations- Get world coordinates where a specific NPC spawns, using data from the OSRS game cache (supports plane filtering and pagination)get_object_spawn_locations- Get world coordinates where a specific game object spawns, using data from the OSRS game cache (supports plane filtering and pagination)
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
Prerequisites
- Node.js (v16 or later)
- npm or yarn
Using npx
npx -y @oddlobster/osrs-wiki-mcp
Global install
npm install -g @oddlobster/osrs-wiki-mcp
From source
git clone https://github.com/oddlobster/osrs-wiki-mcp.git
cd osrs-wiki-mcp
npm install
npm run build
Usage with Claude Code
Via npx
claude mcp add osrs --scope user -- npx -y @oddlobster/osrs-wiki-mcp
Via global install
npm install -g @oddlobster/osrs-wiki-mcp
claude mcp add osrs --scope user -- osrs-wiki-mcp
Troubleshooting
If the npx command doesn't work when adding the MCP server, find your local npx binary path and use the full path instead:
which npx
# e.g. /usr/local/bin/npx
claude mcp add osrs --scope user -- /usr/local/bin/npx -y @oddlobster/osrs-wiki-mcp
Examples
Once the MCP server is added, you can ask Claude Code things like:
- "What's the item ID for dragon scimitar?"
- "Search the wiki for Abyssal whip"
- "What are the stats of the Bandos chestplate?"
- "Find all NPCs with 'dragon' in their name"
- "What varbits are related to quest completion?"
- "List all available game data files"
- "Where does the Goblin (NPC ID 3029) spawn?"
- "What are the spawn locations for oak trees?"
Development
# Install dependencies
npm install
# Start the server in development mode
npm start
# Build the server
npm run build
# Inspect the server
npx @modelcontextprotocol/inspector node dist/index.js
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.
