@mistereman22/osrs-wiki-mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@mistereman22/osrs-wiki-mcp-server
MCP server for the Old School RuneScape Wiki (https://oldschool.runescape.wiki). Serves the full tool surface of @professional-wiki/mediawiki-mcp-server against a pinned, read-only wiki definition.
Capability | Details |
MediaWiki tools | Full upstream tool surface (page reads, search, watchlists, siteinfo, ...) with wiki fixed to |
| On-demand hint list of known Bucket buckets for |
Quick start (users)
Requirement: Node.js >= 22.19.0
OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"osrs-wiki": {
"type": "local",
"command": ["npx", "@mistereman22/osrs-wiki-mcp-server@1.0.0"],
"environment": { "MCP_CONTACT": "you@example.com" }
}
}
}
}Cursor
{
"mcpServers": {
"osrs-wiki": {
"command": "npx",
"args": ["@mistereman22/osrs-wiki-mcp-server@1.0.0"],
"env": { "MCP_CONTACT": "you@example.com" }
}
}
}Claude Code
/plugin marketplace add mistereman22/osrs-wiki-mcp-server
/plugin install osrs-wiki-mcp-server@osrs-wiki-mcp-serverRun directly
MCP_CONTACT="you@example.com" npx @mistereman22/osrs-wiki-mcp-server@1.0.0Related MCP server: osrs-wiki-mcp
Configuration
Variable | Required | Meaning |
| Yes | Your contact (email or name + URL), appended to the server's base User-Agent on every OSRS wiki request. Example: |
Composed User-Agent
osrs-wiki-mcp-server/1.0.0 (https://github.com/mistereman22/osrs-wiki-mcp-server) you@example.comRate limits
Two independent sliding-window budgets (tuned in src/server.ts):
Surface | Budget | Counted per |
MediaWiki API | 30 requests / 60 s | each upstream tool call |
External APIs | 30 requests / 60 s | each HTTP request by external API tool |
Over budget: waits up to 10s for a slot, then returns rate-limit error with retry hint.
Development
Requirements
Node.js >= 22.19.0
npm installin this directory
Commands
npm run build # TypeScript -> dist/
npm start # Run built server (requires MCP_CONTACT)
npm run dev # Build + runRepository layout
.
+-- src/
| +-- index.ts # Entry point: env gate, stdio transport, lifecycle
| +-- env.ts # MCP_CONTACT fail-fast gate + User-Agent composition
| +-- server.ts # McpServer assembly + tool gating + wiki config + rate limiting
| +-- resources.ts # Generic resource loader (bucket-index)
| +-- external.ts # HTTP utilities (callHttp) for future external APIs
| +-- declarations.d.ts # Type declarations for upstream JS-only package
+-- resources/
| +-- bucket-index.md # Bucket hint list for context://bucket-index
+-- .claude-plugin/
| +-- marketplace.json # Claude Code marketplace manifest
+-- dist/ # Compiled output (generated by build)
+-- package.json
+-- tsconfig.json
+-- README.md
+-- LICENSERate limit constants
Tuned in src/server.ts:
WINDOW_MS = 60_000(60s window)MAX_WAIT_MS = 10_000(max 10s wait)WIKI_MAX_REQUESTS = 30EXTERNAL_MAX_REQUESTS = 30
Contact
Maintainer: github.com/mistereman22
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP for the Eco game wiki: search, Markdown pages, and wiki_* lookups. No keys, no writes.
Read-only RS3 GE guide prices/history, optional reported buy/sell trades, buy-limit/alchemy facts, flip math and public hiscores. Search Wiki sources, list category members, and read structured monster/quest/drop facts. Guide prices lag activity; trades are not executable offers. Wiki article text requires reviewed revisions; other pages return links. Streamable HTTP; no account or API key. Independent Birdwell Labs project, unaffiliated with Jagex or the RuneScape Wiki.
Connect to your MediaWiki using simple credentials and manage content without OAuth. Search, read,…
Search and read Wikipedia articles and sections, list cited references, nearby pages, and languages.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables 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.2390 npm39MIT
- AlicenseAqualityBmaintenanceProvides read-only access to Old School RuneScape Wiki data, returning structured content with source provenance via MCP tools for searching pages, items, monsters, quests, shops, and drop sources.10234 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to read, search, create, edit, move, and delete pages and files across any MediaWiki wiki, including extension data from Wikibase, Semantic MediaWiki, Cargo, Bucket, and NeoWiki. Supports multiple wikis with per-wiki resources and OAuth-backed permissions.8 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to search, read, compare, and edit pages on any MediaWiki wiki, including multi-wiki setups with OAuth-authenticated writes. It also queries extension data such as Wikibase entities, Semantic MediaWiki and Cargo results, and Bucket Lua queries.8 npmMIT