Skip to main content
Glama
@mistereman22/osrs-wiki-mcp-server

@mistereman22/osrs-wiki-mcp-server

by mistereman22

@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 oldschool.runescape.wiki. Read-only - write and wiki-management tools are gated off.

context://bucket-index

On-demand hint list of known Bucket buckets for bucket-query; read fresh per request with runtime discovery as fallback.

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-server

Run directly

MCP_CONTACT="you@example.com" npx @mistereman22/osrs-wiki-mcp-server@1.0.0

Related MCP server: osrs-wiki-mcp

Configuration

Variable

Required

Meaning

MCP_CONTACT

Yes

Your contact (email or name + URL), appended to the server's base User-Agent on every OSRS wiki request. Example: you@example.com. Server fails fast at startup if missing.

Composed User-Agent

osrs-wiki-mcp-server/1.0.0 (https://github.com/mistereman22/osrs-wiki-mcp-server) you@example.com

Rate 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 install in this directory

Commands

npm run build   # TypeScript -> dist/
npm start       # Run built server (requires MCP_CONTACT)
npm run dev     # Build + run

Repository 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
+-- LICENSE

Rate limit constants

Tuned in src/server.ts:

  • WINDOW_MS = 60_000 (60s window)

  • MAX_WAIT_MS = 10_000 (max 10s wait)

  • WIKI_MAX_REQUESTS = 30

  • EXTERNAL_MAX_REQUESTS = 30

Contact

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      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.
      23
      90 npm
      39
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      10
      234 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT