@mistereman22/osrs-wiki-mcp-server 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mistereman22/osrs-wiki-mcp-server",
3
- "version": "1.0.2",
3
+ "version": "1.0.3",
4
4
  "description": "MCP server for the Old School RuneScape Wiki: the full MediaWiki MCP tool surface against a pinned read-only wiki.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -95,6 +95,34 @@ get-page "Chest (Tombs of Amascut)" section=2 # Unique drops
95
95
  | Browse category | get-page | `get-page "Category:Bosses"` |
96
96
  | Find exact title variant | search-page-by-prefix | `search-page-by-prefix "Tumeken"` |
97
97
 
98
+ ## Canonical Page Heuristic
99
+
100
+ ### When search returns an obvious index/list page → FETCH IT IMMEDIATELY
101
+
102
+ If a search result's **title** and **snippet** together indicate it's the canonical aggregation page for your topic, stop searching and `get-page` it.
103
+
104
+ | Signal | Example |
105
+ |--------|---------|
106
+ | Title = plural/category name | `"Game updates"`, `"Quest list"`, `"Item sets"` |
107
+ | Snippet shows dated/structured entries | `"lists Easter 2026, Cow Boss, Getting Around Poll in chronological order"` |
108
+ | Title matches your query intent exactly | Search `"2026 updates"` → result `"Game updates"` |
109
+
110
+ ### Anti-pattern to avoid
111
+ ```
112
+ search-page "Game update 2026"
113
+ → result: "Game updates" (snippet: "lists Easter 2026, Cow Boss...")
114
+ → ❌ KEEP SEARCHING for "2026 update" "Easter 2026" etc.
115
+ → ✅ get-page "Game updates" ← canonical page, has everything
116
+ ```
117
+
118
+ ### Why this works
119
+ - Wiki index pages (Game updates, Quest list, Monster drop tables) are **curated, complete, and maintained**
120
+ - Search snippets often reveal the exact structure (chronological, by tier, by category)
121
+ - One `get-page` > 5+ `search-page` calls (rate limit, context, accuracy)
122
+
123
+ ### Quick test
124
+ > "Does this result look like *the* page a human would bookmark for this topic?" → Yes → `get-page`
125
+
98
126
  ## Rate Limit Awareness
99
127
 
100
128
  - Each search tool call counts toward MediaWiki rate limit (30/min)
@@ -37,6 +37,13 @@
37
37
 
38
38
  ## Finding Pages - Strategy
39
39
 
40
+ ### 0. Search hit a canonical index page? Fetch it.
41
+ ```bash
42
+ search-page "2026 game updates"
43
+ # Result: "Game updates" - snippet shows chronological list
44
+ get-page "Game updates" # ← Do this first
45
+ ```
46
+
40
47
  ### 1. Known exact title? Use `get-page` directly
41
48
  ```bash
42
49
  get-page "Abyssal whip"