@xiedada/nodemw-mcp-server 0.0.4 → 0.0.6

package/dist/index.js

@@ -26,12 +26,2144 @@
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */
-import{StdioServerTransport as Ze}from"@modelcontextprotocol/sdk/server/stdio.js";import{parseArgs as to}from"util";import{McpServer as ne}from"@modelcontextprotocol/sdk/server/mcp.js";var K="nodemw-mcp-server/1.0";function Z(e,t=!1){let o,r=t?" Write operations are available.":" Running in guest mode \u2014 only read operations are available.";return e?o=`Connected to ${e.sitename} (${e.base}). Running ${e.generator}.${r} When connecting for the first time, call the get-site-info tool for full site details.`:o=`When connecting to this server for the first time, call the get-site-info tool to understand the target MediaWiki site (version, namespaces, extensions, etc.) before using other tools.${r}`,new ne({name:"nodemw-mcp-server",version:"1.0.0",description:o},{capabilities:{tools:{}}})}import{z as q}from"zod";import se from"nodemw";var F=null,ie=null,tt=!1;function et(e){ie=e}function ot(e){let{server:t,path:o,protocol:r,port:a,proxy:c,userAgent:m,concurrency:p,debug:u,username:g,password:M,domain:U,dryRun:D}=e;return new se({server:t,protocol:r||"https",port:a,path:o,proxy:c,userAgent:m||K,concurrency:p,debug:u,username:g||void 0,password:M||void 0,domain:U,dryRun:D})}async function le(e){try{return await s(e,"getSiteInfo",["general"]),!0}catch{return!1}}async function rt(e){let t=["/w",""];for(let o of t){let r={...e,path:o},a=ot(r);if(await le(a))return o}throw new Error('Could not auto-detect MediaWiki API path. Tried /w/api.php and /api.php. Please specify --path explicitly (e.g., --path /w or --path "" for root).')}async function nt(e){F=ot(e);let{username:t,password:o}=e;return t&&o&&await new Promise((r,a)=>{F.logIn(c=>{c?a(new Error(`Login failed for user '${t}': ${c.message}`)):(tt=!0,r())})}),F}function n(){if(!F)throw new Error("Bot not initialized. Server must be started first.");return F}function st(){return tt}function s(e,t,...o){return new Promise((r,a)=>{let c=(m,p)=>{m?a(m):r(p)};e[t](...o,c)})}function it(e){return e.tool("get-article","Retrieve the content of a wiki article",{title:q.string().describe("Article title"),followRedirect:q.boolean().optional().default(!0).describe("Follow redirects"),redirectInfo:q.boolean().optional().default(!1).describe("Include information about redirects")},{title:"Get article",readOnlyHint:!0,destructiveHint:!1},async({title:t,followRedirect:o,redirectInfo:r})=>ae(t,o,r))}async function ae(e,t,o){try{let r=await n();if(o){let a=await new Promise((u,g)=>{let M=(U,D,re)=>{U?g(U):u([D,re])};r.getArticle(e,t,M)}),[c,m]=a;return c==null?{content:[{type:"text",text:`Page "${e}" not found or has no content.`}],isError:!0}:{content:[{type:"text",text:m?`Content:
 
-${c}
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { parseArgs } from "util";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// package.json
+var package_default = {
+  name: "@xiedada/nodemw-mcp-server",
+  version: "0.0.6",
+  description: "MCP server for nodemw - MediaWiki API client",
+  type: "module",
+  main: "dist/index.js",
+  bin: {
+    "nodemw-mcp-server": "./dist/index.js"
+  },
+  scripts: {
+    build: "node scripts/build.js",
+    dev: "node scripts/build.js --watch",
+    lint: "eslint src/**/*.ts",
+    test: "vitest",
+    prepare: "npm run build",
+    clean: "rimraf dist"
+  },
+  keywords: [
+    "mcp",
+    "mediawiki",
+    "nodemw",
+    "wiki"
+  ],
+  author: "",
+  license: "BSD-2-Clause",
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    nodemw: "^0.26.0",
+    zod: "^3.23.8"
+  },
+  devDependencies: {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    esbuild: "^0.24.0",
+    eslint: "^9.0.0",
+    rimraf: "^5.0.5",
+    typescript: "^5.5.0",
+    vitest: "^2.0.0"
+  },
+  files: [
+    "dist"
+  ],
+  engines: {
+    node: ">=18.0.0"
+  }
+};
+
+// src/server.ts
+var USER_AGENT = "nodemw-mcp-server/1.0";
+function createServer(siteInfo, authenticated2 = false) {
+  let description;
+  const authSuffix = authenticated2 ? " Write operations are available." : " Running in guest mode \u2014 only read operations are available.";
+  if (siteInfo) {
+    description = `Connected to ${siteInfo.sitename} (${siteInfo.base}). Running ${siteInfo.generator}.${authSuffix} When connecting for the first time, call the get-site-info tool for full site details.`;
+  } else {
+    description = `When connecting to this server for the first time, call the get-site-info tool to understand the target MediaWiki site (version, namespaces, extensions, etc.) before using other tools.${authSuffix}`;
+  }
+  return new McpServer(
+    {
+      name: "nodemw-mcp-server",
+      version: package_default.version,
+      description
+    },
+    { capabilities: { tools: {} } }
+  );
+}
+
+// src/tools/ro/get-article.ts
+import { z } from "zod";
+
+// src/common/nodemwBot.ts
+import Bot from "nodemw";
+var botInstance = null;
+var serverConfig = null;
+var authenticated = false;
+function initServerConfig(config) {
+  serverConfig = config;
+}
+function createBotFromConfig(config) {
+  const {
+    server,
+    path,
+    protocol,
+    port,
+    proxy,
+    userAgent,
+    concurrency,
+    debug,
+    username,
+    password,
+    domain,
+    dryRun
+  } = config;
+  return new Bot({
+    server,
+    protocol: protocol || "https",
+    port,
+    path,
+    proxy,
+    userAgent: userAgent || USER_AGENT,
+    concurrency,
+    debug,
+    username: username || void 0,
+    password: password || void 0,
+    domain,
+    // @ts-expect-error: dryRun is supported by nodemw at runtime but missing from BotOptions types
+    dryRun
+  });
+}
+async function testApiConnection(bot) {
+  try {
+    await promisifyBotMethod(bot, "getSiteInfo", ["general"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function autoDetectPath(baseConfig) {
+  const pathsToTry = ["/w", ""];
+  for (const path of pathsToTry) {
+    const testConfig = { ...baseConfig, path };
+    const bot = createBotFromConfig(testConfig);
+    if (await testApiConnection(bot)) {
+      return path;
+    }
+  }
+  throw new Error(
+    'Could not auto-detect MediaWiki API path. Tried /w/api.php and /api.php. Please specify --path explicitly (e.g., --path /w or --path "" for root).'
+  );
+}
+async function initBot(config) {
+  botInstance = createBotFromConfig(config);
+  const { username, password } = config;
+  if (username && password) {
+    await new Promise((resolve, reject) => {
+      botInstance.logIn((err) => {
+        if (err) {
+          reject(new Error(`Login failed for user '${username}': ${err.message}`));
+        } else {
+          authenticated = true;
+          resolve();
+        }
+      });
+    });
+  }
+  return botInstance;
+}
+function getBot() {
+  if (!botInstance) {
+    throw new Error("Bot not initialized. Server must be started first.");
+  }
+  return botInstance;
+}
+function isAuthenticated() {
+  return authenticated;
+}
+function promisifyBotMethod(bot, method, ...args) {
+  return new Promise((resolve, reject) => {
+    const callback = (err, result) => {
+      if (err) {
+        reject(err);
+      } else {
+        resolve(result);
+      }
+    };
+    bot[method](...args, callback);
+  });
+}
+
+// src/common/pageState.ts
+var readState = /* @__PURE__ */ new Map();
+function markAsRead(pageid, revid) {
+  readState.set(pageid, revid);
+}
+function isRead(pageid) {
+  return readState.has(pageid);
+}
+async function requireRead(title) {
+  const bot = getBot();
+  const pages = await promisifyBotMethod(
+    bot,
+    "getArticleInfo",
+    title,
+    { prop: "info" }
+  );
+  if (!Array.isArray(pages) || pages.length === 0) {
+    return 0;
+  }
+  const page = pages[0];
+  if (!page || page.missing) {
+    return 0;
+  }
+  if (page.pageid != null && page.lastrevid != null) {
+    if (!isRead(page.pageid)) {
+      throw new Error(
+        `Page "${title}" (pageid ${page.pageid}) has NOT been read. You MUST call get-article first to fetch the current page content before editing. This is a safety requirement to prevent accidental data loss.`
+      );
+    }
+  }
+  return page.pageid ?? 0;
+}
+
+// src/tools/ro/get-article.ts
+async function recordReadState(title) {
+  try {
+    const bot = await getBot();
+    const pages = await promisifyBotMethod(
+      bot,
+      "getArticleInfo",
+      title,
+      { prop: "info" }
+    );
+    const page = Array.isArray(pages) ? pages[0] : null;
+    if (page?.pageid != null && page?.lastrevid != null) {
+      markAsRead(page.pageid, page.lastrevid);
+    }
+  } catch {
+  }
+}
+function getArticleTool(server) {
+  return server.tool(
+    "get-article",
+    "Retrieve the content of a wiki article",
+    {
+      title: z.string().describe("Article title"),
+      followRedirect: z.boolean().optional().default(true).describe("Follow redirects"),
+      redirectInfo: z.boolean().optional().default(false).describe("Include information about redirects")
+    },
+    {
+      title: "Get article",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title, followRedirect, redirectInfo }) => handleGetArticleTool(title, followRedirect, redirectInfo)
+  );
+}
+async function handleGetArticleTool(title, followRedirect, redirectInfo) {
+  try {
+    const bot = await getBot();
+    if (redirectInfo) {
+      const result = await new Promise((resolve, reject) => {
+        const callback = (err, content2, redirectInfo2) => {
+          if (err) {
+            reject(err);
+          } else {
+            resolve([content2, redirectInfo2]);
+          }
+        };
+        bot.getArticle(title, followRedirect, callback);
+      });
+      const [content, redirect] = result;
+      if (content == null) {
+        return {
+          content: [{ type: "text", text: `Page "${title}" not found or has no content.` }],
+          isError: true
+        };
+      }
+      const responseText = redirect ? `Content:
+
+${content}
 
 Redirect Information:
 
-${JSON.stringify(m,null,2)}`:c}]}}else{let a=await s(r,"getArticle",e,t);return a==null?{content:[{type:"text",text:`Page "${e}" not found or has no content.`}],isError:!0}:{content:[{type:"text",text:a}]}}}catch(r){return{content:[{type:"text",text:`Error: ${r.message}`}],isError:!0}}}import{z as T}from"zod";function l(e){return{content:[{type:"text",text:JSON.stringify(e,null,2)}],structuredContent:e}}function i(e,t){return{content:[{type:"text",text:JSON.stringify({error:e,details:t?.message},null,2)}],isError:!0}}function lt(e){let t=e.tool("search","Search for wiki pages by keyword",{keyword:T.string().describe("Search keyword"),limit:T.number().optional().default(10).describe("Maximum number of results")},{title:"Search",readOnlyHint:!0,destructiveHint:!1},async({keyword:o,limit:r})=>ce(o,r));return t.update({outputSchema:{total:T.number(),limit:T.number(),keyword:T.string(),results:T.array(T.record(T.unknown()))}}),t}async function ce(e,t){try{let o=await n(),r=await s(o,"search",e),a=r.slice(0,t);return l({total:r.length,limit:t,keyword:e,results:a})}catch(o){return i("Failed to search",o)}}import{z as C}from"zod";function at(e){let t=e.tool("get-pages-in-category","Get all pages in a category",{category:C.string().describe("Category name (with or without Category: prefix)")},{title:"Get pages in category",readOnlyHint:!0,destructiveHint:!1},async({category:o})=>me(o));return t.update({outputSchema:{category:C.string(),pages:C.array(C.record(C.unknown())),count:C.number()}}),t}async function me(e){try{let t=await n(),o=e.replace(/^Category:/i,""),r=await s(t,"getPagesInCategory",o);return l({category:o,pages:r,count:r.length})}catch(t){return i("Failed to get pages in category",t)}}import{z as P}from"zod";function ct(e){let t=e.tool("get-categories","Get all categories matching a prefix",{prefix:P.string().optional().default("").describe("Prefix to filter categories")},{title:"Get categories",readOnlyHint:!0,destructiveHint:!1},async({prefix:o})=>pe(o));return t.update({outputSchema:{prefix:P.string(),categories:P.array(P.record(P.unknown())),count:P.number()}}),t}async function pe(e){try{let t=await n(),o=await s(t,"getCategories",e);return l({prefix:e,categories:o,count:o.length})}catch(t){return i("Failed to get categories",t)}}import{z as h}from"zod";function mt(e){let t=e.tool("get-users","Get all users matching a prefix",{prefix:h.string().optional().default("").describe("Prefix to filter usernames"),onlyWithEdits:h.boolean().optional().default(!1).describe("Only include users with at least one edit")},{title:"Get users",readOnlyHint:!0,destructiveHint:!1},async({prefix:o,onlyWithEdits:r})=>ue(o,r));return t.update({outputSchema:{prefix:h.string(),onlyWithEdits:h.boolean(),users:h.array(h.record(h.unknown())),count:h.number()}}),t}async function ue(e,t){try{let o=await n(),r=await s(o,"getUsers",{prefix:e,witheditsonly:t});return l({prefix:e,onlyWithEdits:t,users:r,count:r.length})}catch(o){return i("Failed to get users",o)}}import{z as A}from"zod";function pt(e){let t=e.tool("get-all-pages","Get all non-redirect pages from the wiki",{limit:A.number().optional().default(500).describe("Maximum number of pages to return")},{title:"Get all pages",readOnlyHint:!0,destructiveHint:!1},async({limit:o})=>de(o));return t.update({outputSchema:{total:A.number(),displayed:A.number(),pages:A.array(A.record(A.unknown())),limit:A.number()}}),t}async function de(e){try{let t=await n(),o=await s(t,"getAllPages"),r=o.slice(0,e);return l({total:o.length,displayed:r.length,pages:r,limit:e})}catch(t){return i("Failed to get all pages",t)}}import{z as j}from"zod";function ut(e){let t=e.tool("get-pages-in-namespace","Get all non-redirect pages in a specific namespace",{namespace:j.number().describe("Namespace number to filter pages")},{title:"Get pages in namespace",readOnlyHint:!0,destructiveHint:!1},async({namespace:o})=>ge(o));return t.update({outputSchema:{namespace:j.number(),pages:j.array(j.record(j.unknown())),count:j.number()}}),t}async function ge(e){try{let t=await n(),o=await s(t,"getPagesInNamespace",e);return l({namespace:e,pages:o,count:o.length})}catch(t){return i("Failed to get pages in namespace",t)}}import{z as B}from"zod";function dt(e){let t=e.tool("get-pages-by-prefix","Get pages starting with a specific prefix",{prefix:B.string().describe("Prefix to match page titles")},{title:"Get pages by prefix",readOnlyHint:!0,destructiveHint:!1},async({prefix:o})=>fe(o));return t.update({outputSchema:{prefix:B.string(),pages:B.array(B.record(B.unknown())),count:B.number()}}),t}async function fe(e){try{let t=await n(),o=await s(t,"getPagesByPrefix",e);return l({prefix:e,pages:o,count:o.length})}catch(t){return i("Failed to get pages by prefix",t)}}import{z as E}from"zod";function gt(e){let t=e.tool("get-pages-transcluding","Get all pages that transclude (include) a specific template",{template:E.string().describe("Template title to find transclusions")},{title:"Get pages transcluding template",readOnlyHint:!0,destructiveHint:!1},async({template:o})=>ye(o));return t.update({outputSchema:{template:E.string(),pages:E.array(E.record(E.unknown())),count:E.number()}}),t}async function ye(e){try{let t=await n(),r=(await s(t,"getPagesTranscluding",e))[1],a=Array.isArray(r)?r.filter(c=>c!=null&&typeof c=="object"&&"title"in c):[];return l({template:e,pages:a,count:a.length})}catch(t){return i("Failed to get pages transcluding template",t)}}import{z as R}from"zod";function ft(e){let t=e.tool("get-article-revisions","Get all revisions of a wiki article",{title:R.union([R.string(),R.number()]).describe("Article title or page ID")},{title:"Get article revisions",readOnlyHint:!0,destructiveHint:!1},async({title:o})=>Te(o));return t.update({outputSchema:{title:R.string(),revisions:R.array(R.record(R.unknown())),count:R.number()}}),t}async function Te(e){try{let t=await n(),r=(await s(t,"getArticleRevisions",e)).flat();return l({title:e,revisions:r,count:r.length})}catch(t){return i("Failed to get article revisions",t)}}import{z as b}from"zod";function yt(e){let t=e.tool("get-article-categories","Get all categories that an article belongs to",{title:b.union([b.string(),b.number()]).describe("Article title or page ID")},{title:"Get article categories",readOnlyHint:!0,destructiveHint:!1},async({title:o})=>he(o));return t.update({outputSchema:{title:b.string(),categories:b.array(b.record(b.unknown())),count:b.number()}}),t}async function he(e){try{let t=await n(),o=await s(t,"getArticleCategories",e);return l({title:e,categories:o,count:o.length})}catch(t){return i("Failed to get article categories",t)}}import{z as W}from"zod";function Tt(e){let t=e.tool("get-article-properties","Get page properties for a wiki article",{title:W.string().describe("Article title")},{title:"Get article properties",readOnlyHint:!0,destructiveHint:!1},async({title:o})=>Re(o));return t.update({outputSchema:{title:W.string(),properties:W.record(W.unknown())}}),t}async function Re(e){try{let t=await n(),o=await s(t,"getArticleProperties",e);return l({title:e,properties:o})}catch(t){return i("Failed to get article properties",t)}}import{z as d}from"zod";function ht(e){let t=e.tool("get-article-info","Get detailed information about one or more articles",{title:d.union([d.string(),d.number(),d.array(d.union([d.string(),d.number()]))]).describe("Article title, page ID, or array of titles/IDs"),properties:d.array(d.string()).optional().describe("Specific properties to retrieve")},{title:"Get article info",readOnlyHint:!0,destructiveHint:!1},async({title:o,properties:r})=>be(o,r));return t.update({outputSchema:{title:d.string(),results:d.array(d.record(d.unknown())),count:d.number()}}),t}async function be(e,t){try{let o=await n(),a=await s(o,"getArticleInfo",e,t?{inprop:t}:{}),c=Array.isArray(a)?a:[a];return l({title:e,results:c,count:c.length})}catch(o){return i("Failed to get article info",o)}}import{z as f}from"zod";function Rt(e){let t=e.tool("get-user-contribs","Get contributions made by a specific user",{username:f.string().describe("Username to get contributions for"),namespace:f.number().optional().describe("Filter contributions by namespace"),limit:f.number().optional().default(50).describe("Maximum number of contributions to return")},{title:"Get user contributions",readOnlyHint:!0,destructiveHint:!1},async({username:o,namespace:r,limit:a})=>xe(o,r,a));return t.update({outputSchema:{username:f.string(),namespace:f.number(),limit:f.number(),total:f.number(),displayed:f.number(),contributions:f.array(f.record(f.unknown()))}}),t}async function xe(e,t,o=50){try{let r=await n(),a={user:e,...t!==void 0&&{namespace:t}},c=await s(r,"getUserContribs",a),m=Array.isArray(c[1])?c[1]:[],p=m.slice(0,o);return l({username:e,namespace:t,limit:o,total:m.length,displayed:p.length,contributions:p})}catch(r){return i("Failed to get user contributions",r)}}function bt(e){let t=e.tool("whoami","Get information about the currently logged in user",{},{title:"Who am I",readOnlyHint:!0,destructiveHint:!1},async()=>ve());return t.update({outputSchema:{}}),t}async function ve(){try{let e=await n(),t=await s(e,"whoami");return l(t)}catch(e){return i("Failed to get current user info",e)}}import{z as we}from"zod";function xt(e){let t=e.tool("whois","Get information about a specific user",{username:we.string().describe("Username to look up")},{title:"Whois",readOnlyHint:!0,destructiveHint:!1},async({username:o})=>ke(o));return t.update({outputSchema:{}}),t}async function ke(e){try{let t=await n(),o=await s(t,"whois",e);return o.missing?i(`User "${e}" not found.`):l(o)}catch(t){return i("Failed to get user info",t)}}import{z as vt}from"zod";function wt(e){let t=e.tool("whoare","Get information about multiple wiki users",{usernames:vt.array(vt.string()).describe("Array of usernames to query")},{title:"Who are",readOnlyHint:!0,destructiveHint:!1},async o=>Se(o));return t.update({outputSchema:{}}),t}async function Se(e){try{let t=await n(),o=await s(t,"whoare",e.usernames);return l(o)}catch(t){return i("Failed to get user information",t)}}import{z as x}from"zod";function kt(e){let t=e.tool("get-images","Get list of images starting from a specific name",{startFrom:x.string().optional().default("").describe("Start from this image name"),limit:x.number().optional().default(50).describe("Maximum number of images to return")},{title:"Get images",readOnlyHint:!0,destructiveHint:!1},async({startFrom:o,limit:r})=>Ae(o,r));return t.update({outputSchema:{total:x.number(),limit:x.number(),startFrom:x.string(),images:x.array(x.record(x.unknown()))}}),t}async function Ae(e,t){try{let o=await n(),r=await new Promise((c,m)=>{o.getImages(e,(p,...u)=>{if(p)m(p);else{let g=u[0];c(Array.isArray(g)?g:[])}})}),a=r.slice(0,t);return l({total:r.length,limit:t,startFrom:e,images:a})}catch(o){return i("Failed to get images",o)}}import{z as v}from"zod";function St(e){let t=e.tool("get-images-from-article","Get all images embedded in a specific article",{title:v.union([v.string(),v.number()]).describe("Article title or page ID")},{title:"Get images from article",readOnlyHint:!0,destructiveHint:!1},async({title:o})=>Me(o));return t.update({outputSchema:{title:v.string(),images:v.array(v.record(v.unknown())),count:v.number()}}),t}async function Me(e){try{let t=await n(),o=await s(t,"getImagesFromArticle",e);return l({title:e,images:o,count:o.length})}catch(t){return i("Failed to get images from article",t)}}import{z as H}from"zod";function At(e){let t=e.tool("get-image-usage","Get all pages that use a specific image",{filename:H.string().describe("Image filename with File: prefix")},{title:"Get image usage",readOnlyHint:!0,destructiveHint:!1},async({filename:o})=>Ce(o));return t.update({outputSchema:{filename:H.string(),pages:H.array(H.record(H.unknown())),count:H.number()}}),t}async function Ce(e){try{let t=await n(),o=await s(t,"getImageUsage",e);return l({filename:e,pages:o,count:o.length})}catch(t){return i("Failed to get image usage",t)}}import{z as $}from"zod";function Mt(e){let t=e.tool("get-image-info","Get detailed information about an image file",{filename:$.string().describe("Image filename with File: prefix")},{title:"Get image info",readOnlyHint:!0,destructiveHint:!1},async({filename:o})=>Pe(o));return t.update({outputSchema:{filename:$.string(),info:$.record($.unknown())}}),t}async function Pe(e){try{let t=await n(),o=await s(t,"getImageInfo",e);return o?l({filename:e,info:o}):i(`Image "${e}" not found.`)}catch(t){return i("Failed to get image info",t)}}import{z as y}from"zod";function Ct(e){let t=e.tool("get-log","Get log entries of a specific type",{type:y.string().describe("Log type (e.g. delete, block, move)"),start:y.string().optional().default("").describe("Start timestamp (YYYYMMDDHHMMSS format)"),limit:y.number().optional().default(50).describe("Maximum number of entries to return")},{title:"Get log entries",readOnlyHint:!0,destructiveHint:!1},async({type:o,start:r,limit:a})=>je(o,r,a));return t.update({outputSchema:{type:y.string(),start:y.string(),limit:y.number(),total:y.number(),displayed:y.number(),entries:y.array(y.record(y.unknown()))}}),t}async function je(e,t,o){try{let r=await n(),a=await new Promise((m,p)=>{r.getLog(e,t,(u,...g)=>{if(u)p(u);else{let M=g[0];m(Array.isArray(M)?M:[])}})}),c=a.slice(0,o);return l({type:e,start:t,limit:o,total:a.length,displayed:c.length,entries:c})}catch(r){return i("Failed to get log entries",r)}}import{z as Pt}from"zod";function jt(e){return e.tool("expand-templates","Expand templates in wikitext",{text:Pt.string().describe("Wikitext with templates to expand"),title:Pt.string().optional().describe("Context page title")},{title:"Expand templates",readOnlyHint:!0,destructiveHint:!1},async({text:t,title:o})=>Be(t,o))}async function Be(e,t){try{let o=await n(),r=await s(o,"expandTemplates",e,t||"");return r==null?{content:[{type:"text",text:`Failed to expand templates for "${e}".`}],isError:!0}:{content:[{type:"text",text:r}]}}catch(o){return{content:[{type:"text",text:`Error: ${o.message}`}],isError:!0}}}import{z as Bt}from"zod";function Et(e){return e.tool("parse","Parse wikitext to HTML",{text:Bt.string().describe("Wikitext to parse"),title:Bt.string().optional().describe("Context page title")},{title:"Parse wikitext",readOnlyHint:!0,destructiveHint:!1},async({text:t,title:o})=>Ee(t,o))}async function Ee(e,t){try{let o=await n(),r=await s(o,"parse",e,t||""),a=r[1]||"",c=Array.isArray(r[2])?r[2]:[];return{content:[{type:"text",text:["Parsed XML structure:","",a,"",`Images found: ${c.length>0?c.join(", "):"none"}`].join(`
-`)}]}}catch(o){return{content:[{type:"text",text:`Error: ${o.message}`}],isError:!0}}}import{z as w}from"zod";function Ht(e){let t=e.tool("get-recent-changes","Get recent changes on the wiki",{start:w.string().optional().describe("Start timestamp"),limit:w.number().optional().default(50).describe("Maximum number of changes to return")},{title:"Get recent changes",readOnlyHint:!0,destructiveHint:!1},async({start:o,limit:r})=>He(o,r));return t.update({outputSchema:{total:w.number(),limit:w.number(),start:w.string(),changes:w.array(w.record(w.unknown()))}}),t}async function He(e,t=50){try{let o=await n(),r=await new Promise((c,m)=>{o.getRecentChanges(e,(p,...u)=>{if(p)m(p);else{let g=u[0];c(Array.isArray(g)?g:[])}})}),a=r.slice(0,t);return l({total:r.length,limit:t,start:e,changes:a})}catch(o){return i("Failed to get recent changes",o)}}import{z as It}from"zod";function Gt(e){let t=e.tool("get-site-info","Get site information from MediaWiki",{properties:It.array(It.string()).describe("List of site information properties to retrieve")},{title:"Get site info",readOnlyHint:!0,destructiveHint:!1},async({properties:o})=>Ie(o));return t.update({outputSchema:{}}),t}async function Ie(e){try{let t=await n(),o=await s(t,"getSiteInfo",e);return l(o||{})}catch(t){return i("Failed to get site info",t)}}function Ft(e){let t=e.tool("get-site-stats","Get site statistics",{},{title:"Get site stats",readOnlyHint:!0,destructiveHint:!1},async()=>Ge());return t.update({outputSchema:{}}),t}async function Ge(){try{let e=await n(),t=await s(e,"getSiteStats");return l(t)}catch(e){return i("Failed to get site stats",e)}}function Ot(e){let t=e.tool("get-mediawiki-version","Get MediaWiki version running on the server",{},{title:"Get MediaWiki version",readOnlyHint:!0,destructiveHint:!1},async()=>Fe());return t.update({outputSchema:{version:z.string()}}),t}async function Fe(){try{let e=await n(),t=await s(e,"getMediaWikiVersion");return l({version:t})}catch(e){return i("Failed to get MediaWiki version",e)}}import{z as I}from"zod";function Ut(e){let t=e.tool("get-query-page","Get results from a query page (special page)",{name:I.string().describe("Name of the query page")},{title:"Get query page results",readOnlyHint:!0,destructiveHint:!1},async({name:o})=>Oe(o));return t.update({outputSchema:{name:I.string(),results:I.array(I.record(I.unknown())),count:I.number()}}),t}async function Oe(e){try{let t=await n(),o=await s(t,"getQueryPage",e);return l({name:e,results:o,count:o.length})}catch(t){return i("Failed to get query page results",t)}}import{z as k}from"zod";function zt(e){let t=e.tool("get-external-links","Get all external links from an article",{title:k.union([k.string(),k.number()]).describe("Article title or page ID")},{title:"Get external links",readOnlyHint:!0,destructiveHint:!1},async({title:o})=>Ue(o));return t.update({outputSchema:{title:k.string(),links:k.array(k.record(k.unknown())),count:k.number()}}),t}async function Ue(e){try{let t=await n(),o=await s(t,"getExternalLinks",e);return l({title:e,links:o.map(r=>r["*"]),count:o.length})}catch(t){return i("Failed to get external links",t)}}import{z as G}from"zod";function Wt(e){let t=e.tool("get-backlinks","Get all backlinks to a specific page",{title:G.string().describe("Target page title to find backlinks for")},{title:"Get backlinks",readOnlyHint:!0,destructiveHint:!1},async({title:o})=>ze(o));return t.update({outputSchema:{target:G.string(),backlinks:G.array(G.record(G.unknown())),count:G.number()}}),t}async function ze(e){try{let t=await n(),o=await s(t,"getBacklinks",e);return l({target:e,backlinks:o,count:o.length})}catch(t){return i("Failed to get backlinks",t)}}import{z as N}from"zod";function $t(e){let t=e.tool("edit","Edit a wiki page (requires authentication)",{title:N.string().describe("Page title to edit"),content:N.string().describe("New content for the page"),summary:N.string().describe("Edit summary"),minor:N.boolean().optional().default(!1).describe("Mark as minor edit")},{title:"Edit page",readOnlyHint:!1,destructiveHint:!0},async o=>We(o));return t.update({outputSchema:{}}),t}async function We(e){try{let t=await n(),o=`[nodemw-mcp] ${e.summary}`,r=await s(t,"edit",e.title,e.content,o,e.minor||!1);return l(r)}catch(t){return i("Failed to edit page",t)}}import{z as O}from"zod";function Nt(e){let t=e.tool("append","Append content to a wiki page (requires authentication)",{title:O.string().describe("Page title"),content:O.string().describe("Content to append"),summary:O.string().describe("Edit summary")},{title:"Append to page",readOnlyHint:!1,destructiveHint:!0},async o=>$e(o));return t.update({outputSchema:{success:O.boolean(),title:O.string()}}),t}async function $e(e){try{let t=await n(),o=`[nodemw-mcp] ${e.summary}`;return await s(t,"append",e.title,e.content,o),l({success:!0,title:e.title})}catch(t){return i("Failed to append to page",t)}}import{z as _}from"zod";function Lt(e){let t=e.tool("prepend","Prepend content to a wiki page (requires authentication)",{title:_.string().describe("Page title to prepend to"),content:_.string().describe("Content to prepend"),summary:_.string().describe("Edit summary")},{title:"Prepend to page",readOnlyHint:!1,destructiveHint:!0},async o=>Ne(o));return t.update({outputSchema:{}}),t}async function Ne(e){try{let t=await n(),o=`[nodemw-mcp] ${e.summary}`,r=await s(t,"prepend",e.title,e.content,o);return l(r)}catch(t){return i("Failed to prepend to page",t)}}import{z as Q}from"zod";function Dt(e){let t=e.tool("move","Move (rename) a wiki page (requires authentication)",{from:Q.string().describe("Current page title"),to:Q.string().describe("New page title"),summary:Q.string().describe("Move summary")},{title:"Move page",readOnlyHint:!1,destructiveHint:!0},async o=>Le(o));return t.update({outputSchema:{}}),t}async function Le(e){try{let t=await n(),o=`[nodemw-mcp] ${e.summary}`,r=await s(t,"move",e.from,e.to,o);return l(r)}catch(t){return i("Failed to move page",t)}}import{z as qt}from"zod";function _t(e){let t=e.tool("delete","Delete a wiki page (requires authentication)",{title:qt.string().describe("Page title to delete"),reason:qt.string().describe("Reason for deletion")},{title:"Delete page",readOnlyHint:!1,destructiveHint:!0},async o=>De(o));return t.update({outputSchema:{}}),t}async function De(e){try{let t=await n(),o=`[nodemw-mcp] ${e.reason}`,r=await s(t,"delete",e.title,o);return l(r)}catch(t){return i("Failed to delete page",t)}}import{z as S}from"zod";function Qt(e){let t=e.tool("protect","Protect a wiki page (requires authentication)",{title:S.string().describe("Page title to protect"),protections:S.array(S.object({type:S.string().describe("Action type (e.g., edit, move)"),level:S.string().optional().default("all").describe("Protection level (e.g., sysop, autoconfirmed)"),expiry:S.string().optional().describe("Expiry time (e.g., 1 week, never)")})).describe("Protection settings"),reason:S.string().optional().describe("Reason for protection"),cascade:S.boolean().optional().default(!1).describe("Apply cascade protection")},{title:"Protect page",readOnlyHint:!1,destructiveHint:!0},async o=>qe(o));return t.update({outputSchema:{}}),t}async function qe(e){try{let t=await n(),o={};e.reason&&(o.reason=`[nodemw-mcp] ${e.reason}`),e.cascade&&(o.cascade=e.cascade);let r=await s(t,"protect",e.title,e.protections,o);return l(r)}catch(t){return i("Failed to protect page",t)}}import{z as L}from"zod";function Vt(e){let t=e.tool("purge","Purge cache for wiki pages",{titles:L.union([L.string(),L.array(L.string())]).describe("Page title(s) or category to purge")},{title:"Purge pages",readOnlyHint:!1,destructiveHint:!1},async o=>_e(o));return t.update({outputSchema:{}}),t}async function _e(e){try{let t=await n(),o=await s(t,"purge",e.titles);return l(o)}catch(t){return i("Failed to purge pages",t)}}import{z as V}from"zod";function Yt(e){let t=e.tool("send-email","Send email to a wiki user (requires authentication)",{username:V.string().describe("Username to email"),subject:V.string().describe("Email subject"),text:V.string().describe("Email content")},{title:"Send email",readOnlyHint:!1,destructiveHint:!1},async o=>Qe(o));return t.update({outputSchema:{}}),t}async function Qe(e){try{let t=await n(),o=await s(t,"sendEmail",e.username,e.subject,e.text);return l(o)}catch(t){return i("Failed to send email",t)}}import{z as Y}from"zod";function Jt(e){let t=e.tool("upload","Upload a file to wiki (requires authentication)",{filename:Y.string().describe("Destination filename on wiki"),content:Y.string().describe("File content as base64 string"),comment:Y.string().optional().describe("Upload comment")},{title:"Upload file",readOnlyHint:!1,destructiveHint:!1},async o=>Ve(o));return t.update({outputSchema:{}}),t}async function Ve(e){try{let t=await n(),o=Buffer.from(e.content,"base64"),r=e.comment?`[nodemw-mcp] ${e.comment}`:"[nodemw-mcp] File upload",a=await s(t,"upload",e.filename,o,r);return l(a)}catch(t){return i("Failed to upload file",t)}}import{z as J}from"zod";function Xt(e){let t=e.tool("upload-by-url","Upload a file to wiki from URL (requires authentication)",{filename:J.string().describe("Destination filename on wiki"),url:J.string().url().describe("Source URL to download file from"),summary:J.string().optional().describe("Upload summary")},{title:"Upload file by URL",readOnlyHint:!1,destructiveHint:!1},async o=>Ye(o));return t.update({outputSchema:{}}),t}async function Ye(e){try{let t=await n(),o=e.summary?`[nodemw-mcp] ${e.summary}`:"[nodemw-mcp] File upload from URL",r=await s(t,"uploadByUrl",e.filename,e.url,o);return l(r)}catch(t){return i("Failed to upload file by URL",t)}}import{z as X}from"zod";function Kt(e){let t=e.tool("add-flow-topic","Add a new Flow topic to a wiki page (requires authentication)",{title:X.string().describe("Page title to add topic to"),subject:X.string().describe("Topic subject"),content:X.string().describe("Topic content in wikitext")},{title:"Add Flow topic",readOnlyHint:!1,destructiveHint:!1},async o=>Je(o));return t.update({outputSchema:{}}),t}async function Je(e){try{let t=await n(),o=await s(t,"addFlowTopic",e.title,e.subject,e.content);return l(o)}catch(t){return i("Failed to add Flow topic",t)}}import{z as Zt}from"zod";function te(e){let t=e.tool("create-account","Create a new MediaWiki user account (requires authentication)",{username:Zt.string().describe("New account username"),password:Zt.string().describe("New account password")},{title:"Create user account",readOnlyHint:!1,destructiveHint:!1},async o=>Xe(o));return t.update({outputSchema:{}}),t}async function Xe(e){try{let t=await n(),o=await s(t,"createAccount",e.username,e.password);return l(o)}catch(t){return i("Failed to create account",t)}}var ee=[it,lt,at,ct,mt,pt,ut,dt,gt,ft,yt,Tt,ht,Rt,bt,xt,wt,kt,St,At,Mt,Ct,jt,Et,Ht,Gt,Ft,Ot,Ut,zt,Wt],Ke=[$t,Nt,Lt,Dt,_t,Qt,Vt,Yt,Jt,Xt,Kt,te];function oe(e,t=!0){let o=t?[...ee,...Ke]:ee,r=[];for(let a of o)try{r.push(a(e))}catch(c){console.error(`Error registering tool: ${c.message}`)}return r}function eo(){let{values:e,positionals:t}=to({options:{server:{type:"string",short:"s"},path:{type:"string"},endpoint:{type:"string"},user:{type:"string",short:"u"},pass:{type:"string",short:"p"},token:{type:"string"},"dry-run":{type:"boolean"}},strict:!1,allowPositionals:!0}),o=e.server??t[0]??process.env.NODEMW_MCP_SERVER;o||(console.error("Error: target server is required (-s, positional arg, or NODEMW_MCP_SERVER env)"),process.exit(1));let r,a,c;try{if(o.startsWith("http://")||o.startsWith("https://")){let u=new URL(o);r=u.hostname,a=u.protocol.replace(":",""),u.port&&(c=parseInt(u.port,10))}else r=o}catch{r=o}let m=process.env.NODEMW_MCP_ENDPOINT_PATH,p=!!(e.path??e.endpoint??m);return{config:{server:r,protocol:a,port:c,path:e.path??e.endpoint??m??"/w",username:e.user??process.env.NODEMW_MCP_MW_USER,password:e.pass??process.env.NODEMW_MCP_MW_PASS,token:e.token,dryRun:e["dry-run"]},pathExplicit:p}}async function oo(){let{config:e,pathExplicit:t}=eo();if(!t)try{e.path=await rt(e),console.error(`Auto-detected API path: ${e.path}`)}catch(p){console.error("Error:",p.message),process.exit(1)}et(e);try{await nt(e)}catch(p){console.error("Error:",p.message),process.exit(1)}let o=n(),r;try{let u=(await s(o,"getSiteInfo",["general"]))?.general;u&&(r={sitename:u.sitename||"Unknown",base:u.base||"",generator:u.generator||"MediaWiki"})}catch{console.error("Warning: Could not fetch site info for server description.")}let a=st(),c=Z(r,a);oe(c,a);let m=new Ze;await c.connect(m)}oo().catch(console.error);
-//# sourceMappingURL=index.js.map
+${JSON.stringify(redirect, null, 2)}` : content;
+      await recordReadState(title);
+      return {
+        content: [{ type: "text", text: responseText }]
+      };
+    } else {
+      const result = await promisifyBotMethod(
+        bot,
+        "getArticle",
+        title,
+        followRedirect
+      );
+      if (result == null) {
+        return {
+          content: [{ type: "text", text: `Page "${title}" not found or has no content.` }],
+          isError: true
+        };
+      }
+      await recordReadState(title);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    }
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true
+    };
+  }
+}
+
+// src/tools/ro/search.ts
+import { z as z2 } from "zod";
+
+// src/common/utils.ts
+function jsonResult(data) {
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify(data, null, 2)
+    }],
+    structuredContent: data
+  };
+}
+function errorResult(message, error) {
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify({
+        error: message,
+        details: error?.message
+      }, null, 2)
+    }],
+    isError: true
+  };
+}
+
+// src/tools/ro/search.ts
+function searchTool(server) {
+  const tool = server.tool(
+    "search",
+    "Search for wiki pages by keyword",
+    {
+      keyword: z2.string().describe("Search keyword"),
+      limit: z2.number().optional().default(10).describe("Maximum number of results")
+    },
+    {
+      title: "Search",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ keyword, limit }) => handleSearchTool(keyword, limit)
+  );
+  tool.update({ outputSchema: { total: z2.number(), limit: z2.number(), keyword: z2.string(), results: z2.array(z2.record(z2.unknown())) } });
+  return tool;
+}
+async function handleSearchTool(keyword, limit) {
+  try {
+    const bot = await getBot();
+    const results = await promisifyBotMethod(
+      bot,
+      "search",
+      keyword
+    );
+    const limitedResults = results.slice(0, limit);
+    return jsonResult({
+      total: results.length,
+      limit,
+      keyword,
+      results: limitedResults
+    });
+  } catch (error) {
+    return errorResult("Failed to search", error);
+  }
+}
+
+// src/tools/ro/get-pages-in-category.ts
+import { z as z3 } from "zod";
+function getPagesInCategoryTool(server) {
+  const tool = server.tool(
+    "get-pages-in-category",
+    "Get all pages in a category",
+    {
+      category: z3.string().describe("Category name (with or without Category: prefix)")
+    },
+    {
+      title: "Get pages in category",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ category }) => handleGetPagesInCategoryTool(category)
+  );
+  tool.update({ outputSchema: { category: z3.string(), pages: z3.array(z3.record(z3.unknown())), count: z3.number() } });
+  return tool;
+}
+async function handleGetPagesInCategoryTool(category) {
+  try {
+    const bot = await getBot();
+    const cleanCategory = category.replace(/^Category:/i, "");
+    const results = await promisifyBotMethod(
+      bot,
+      "getPagesInCategory",
+      cleanCategory
+    );
+    return jsonResult({
+      category: cleanCategory,
+      pages: results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get pages in category", error);
+  }
+}
+
+// src/tools/ro/get-categories.ts
+import { z as z4 } from "zod";
+function getCategoriesTool(server) {
+  const tool = server.tool(
+    "get-categories",
+    "Get all categories matching a prefix",
+    {
+      prefix: z4.string().optional().default("").describe("Prefix to filter categories")
+    },
+    {
+      title: "Get categories",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ prefix }) => handleGetCategoriesTool(prefix)
+  );
+  tool.update({ outputSchema: { prefix: z4.string(), categories: z4.array(z4.record(z4.unknown())), count: z4.number() } });
+  return tool;
+}
+async function handleGetCategoriesTool(prefix) {
+  try {
+    const bot = await getBot();
+    const results = await promisifyBotMethod(
+      bot,
+      "getCategories",
+      prefix
+    );
+    return jsonResult({
+      prefix,
+      categories: results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get categories", error);
+  }
+}
+
+// src/tools/ro/get-users.ts
+import { z as z5 } from "zod";
+function getUsersTool(server) {
+  const tool = server.tool(
+    "get-users",
+    "Get all users matching a prefix",
+    {
+      prefix: z5.string().optional().default("").describe("Prefix to filter usernames"),
+      onlyWithEdits: z5.boolean().optional().default(false).describe("Only include users with at least one edit")
+    },
+    {
+      title: "Get users",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ prefix, onlyWithEdits }) => handleGetUsersTool(prefix, onlyWithEdits)
+  );
+  tool.update({ outputSchema: { prefix: z5.string(), onlyWithEdits: z5.boolean(), users: z5.array(z5.record(z5.unknown())), count: z5.number() } });
+  return tool;
+}
+async function handleGetUsersTool(prefix, onlyWithEdits) {
+  try {
+    const bot = await getBot();
+    const results = await promisifyBotMethod(
+      bot,
+      "getUsers",
+      { prefix, witheditsonly: onlyWithEdits }
+    );
+    return jsonResult({
+      prefix,
+      onlyWithEdits,
+      users: results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get users", error);
+  }
+}
+
+// src/tools/ro/get-all-pages.ts
+import { z as z6 } from "zod";
+function getAllPagesTool(server) {
+  const tool = server.tool(
+    "get-all-pages",
+    "Get all non-redirect pages from the wiki",
+    {
+      limit: z6.number().optional().default(500).describe("Maximum number of pages to return")
+    },
+    {
+      title: "Get all pages",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ limit }) => handleGetAllPagesTool(limit)
+  );
+  tool.update({ outputSchema: { total: z6.number(), displayed: z6.number(), pages: z6.array(z6.record(z6.unknown())), limit: z6.number() } });
+  return tool;
+}
+async function handleGetAllPagesTool(limit) {
+  try {
+    const bot = await getBot();
+    const allResults = await promisifyBotMethod(
+      bot,
+      "getAllPages"
+    );
+    const results = allResults.slice(0, limit);
+    return jsonResult({
+      total: allResults.length,
+      displayed: results.length,
+      pages: results,
+      limit
+    });
+  } catch (error) {
+    return errorResult("Failed to get all pages", error);
+  }
+}
+
+// src/tools/ro/get-pages-in-namespace.ts
+import { z as z7 } from "zod";
+function getPagesInNamespaceTool(server) {
+  const tool = server.tool(
+    "get-pages-in-namespace",
+    "Get all non-redirect pages in a specific namespace",
+    {
+      namespace: z7.number().describe("Namespace number to filter pages")
+    },
+    {
+      title: "Get pages in namespace",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ namespace }) => handleGetPagesInNamespaceTool(namespace)
+  );
+  tool.update({ outputSchema: { namespace: z7.number(), pages: z7.array(z7.record(z7.unknown())), count: z7.number() } });
+  return tool;
+}
+async function handleGetPagesInNamespaceTool(namespace) {
+  try {
+    const bot = await getBot();
+    const results = await promisifyBotMethod(
+      bot,
+      "getPagesInNamespace",
+      namespace
+    );
+    return jsonResult({
+      namespace,
+      pages: results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get pages in namespace", error);
+  }
+}
+
+// src/tools/ro/get-pages-by-prefix.ts
+import { z as z8 } from "zod";
+function getPagesByPrefixTool(server) {
+  const tool = server.tool(
+    "get-pages-by-prefix",
+    "Get pages starting with a specific prefix",
+    {
+      prefix: z8.string().describe("Prefix to match page titles")
+    },
+    {
+      title: "Get pages by prefix",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ prefix }) => handleGetPagesByPrefixTool(prefix)
+  );
+  tool.update({ outputSchema: { prefix: z8.string(), pages: z8.array(z8.record(z8.unknown())), count: z8.number() } });
+  return tool;
+}
+async function handleGetPagesByPrefixTool(prefix) {
+  try {
+    const bot = await getBot();
+    const results = await promisifyBotMethod(
+      bot,
+      "getPagesByPrefix",
+      prefix
+    );
+    return jsonResult({
+      prefix,
+      pages: results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get pages by prefix", error);
+  }
+}
+
+// src/tools/ro/get-pages-transcluding.ts
+import { z as z9 } from "zod";
+function getPagesTranscludingTool(server) {
+  const tool = server.tool(
+    "get-pages-transcluding",
+    "Get all pages that transclude (include) a specific template",
+    {
+      template: z9.string().describe("Template title to find transclusions")
+    },
+    {
+      title: "Get pages transcluding template",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ template }) => handleGetPagesTranscludingTool(template)
+  );
+  tool.update({ outputSchema: { template: z9.string(), pages: z9.array(z9.record(z9.unknown())), count: z9.number() } });
+  return tool;
+}
+async function handleGetPagesTranscludingTool(template) {
+  try {
+    const bot = await getBot();
+    const callbackArgs = await promisifyBotMethod(
+      bot,
+      "getPagesTranscluding",
+      template
+    );
+    const rawResults = callbackArgs[1];
+    const results = Array.isArray(rawResults) ? rawResults.filter((page) => page != null && typeof page === "object" && "title" in page) : [];
+    return jsonResult({
+      template,
+      pages: results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get pages transcluding template", error);
+  }
+}
+
+// src/tools/ro/get-article-revisions.ts
+import { z as z10 } from "zod";
+function getArticleRevisionsTool(server) {
+  const tool = server.tool(
+    "get-article-revisions",
+    "Get all revisions of a wiki article",
+    {
+      title: z10.union([z10.string(), z10.number()]).describe("Article title or page ID")
+    },
+    {
+      title: "Get article revisions",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title }) => handleGetArticleRevisionsTool(title)
+  );
+  tool.update({ outputSchema: { title: z10.string(), revisions: z10.array(z10.record(z10.unknown())), count: z10.number() } });
+  return tool;
+}
+async function handleGetArticleRevisionsTool(title) {
+  try {
+    const bot = await getBot();
+    const allRevisions = await promisifyBotMethod(
+      bot,
+      "getArticleRevisions",
+      title
+    );
+    const revisions = allRevisions.flat();
+    return jsonResult({
+      title,
+      revisions,
+      count: revisions.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get article revisions", error);
+  }
+}
+
+// src/tools/ro/get-article-categories.ts
+import { z as z11 } from "zod";
+function getArticleCategoriesTool(server) {
+  const tool = server.tool(
+    "get-article-categories",
+    "Get all categories that an article belongs to",
+    {
+      title: z11.union([z11.string(), z11.number()]).describe("Article title or page ID")
+    },
+    {
+      title: "Get article categories",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title }) => handleGetArticleCategoriesTool(title)
+  );
+  tool.update({ outputSchema: { title: z11.string(), categories: z11.array(z11.string()), count: z11.number() } });
+  return tool;
+}
+async function handleGetArticleCategoriesTool(title) {
+  try {
+    const bot = await getBot();
+    const categories = await promisifyBotMethod(
+      bot,
+      "getArticleCategories",
+      title
+    );
+    return jsonResult({
+      title,
+      categories,
+      count: categories.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get article categories", error);
+  }
+}
+
+// src/tools/ro/get-article-properties.ts
+import { z as z12 } from "zod";
+function getArticlePropertiesTool(server) {
+  const tool = server.tool(
+    "get-article-properties",
+    "Get page properties for a wiki article",
+    {
+      title: z12.string().describe("Article title")
+    },
+    {
+      title: "Get article properties",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title }) => handleGetArticlePropertiesTool(title)
+  );
+  tool.update({ outputSchema: { title: z12.string(), properties: z12.record(z12.unknown()) } });
+  return tool;
+}
+async function handleGetArticlePropertiesTool(title) {
+  try {
+    const bot = await getBot();
+    const properties = await promisifyBotMethod(
+      bot,
+      "getArticleProperties",
+      title
+    );
+    return jsonResult({
+      title,
+      properties
+    });
+  } catch (error) {
+    return errorResult("Failed to get article properties", error);
+  }
+}
+
+// src/tools/ro/get-article-info.ts
+import { z as z13 } from "zod";
+function getArticleInfoTool(server) {
+  const tool = server.tool(
+    "get-article-info",
+    "Get detailed information about one or more articles",
+    {
+      title: z13.union([
+        z13.string(),
+        z13.number(),
+        z13.array(z13.union([z13.string(), z13.number()]))
+      ]).describe("Article title, page ID, or array of titles/IDs"),
+      properties: z13.array(z13.string()).optional().describe("Specific properties to retrieve")
+    },
+    {
+      title: "Get article info",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title, properties }) => handleGetArticleInfoTool(title, properties)
+  );
+  tool.update({ outputSchema: { title: z13.string(), results: z13.array(z13.record(z13.unknown())), count: z13.number() } });
+  return tool;
+}
+async function handleGetArticleInfoTool(title, properties) {
+  try {
+    const bot = await getBot();
+    const options = properties ? { inprop: properties } : {};
+    const info = await promisifyBotMethod(
+      bot,
+      "getArticleInfo",
+      title,
+      options
+    );
+    const results = Array.isArray(info) ? info : [info];
+    return jsonResult({
+      title,
+      results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get article info", error);
+  }
+}
+
+// src/tools/ro/get-user-contribs.ts
+import { z as z14 } from "zod";
+function getUserContribsTool(server) {
+  const tool = server.tool(
+    "get-user-contribs",
+    "Get contributions made by a specific user",
+    {
+      username: z14.string().describe("Username to get contributions for"),
+      namespace: z14.number().optional().describe("Filter contributions by namespace"),
+      limit: z14.number().optional().default(50).describe("Maximum number of contributions to return")
+    },
+    {
+      title: "Get user contributions",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ username, namespace, limit }) => handleGetUserContribsTool(username, namespace, limit)
+  );
+  tool.update({ outputSchema: { username: z14.string(), namespace: z14.number(), limit: z14.number(), total: z14.number(), displayed: z14.number(), contributions: z14.array(z14.record(z14.unknown())) } });
+  return tool;
+}
+async function handleGetUserContribsTool(username, namespace, limit = 50) {
+  try {
+    const bot = await getBot();
+    const options = {
+      user: username,
+      ...namespace !== void 0 && { namespace }
+    };
+    const callbackArgs = await promisifyBotMethod(
+      bot,
+      "getUserContribs",
+      options
+    );
+    const contribs = Array.isArray(callbackArgs[1]) ? callbackArgs[1] : [];
+    const limitedContribs = contribs.slice(0, limit);
+    return jsonResult({
+      username,
+      namespace,
+      limit,
+      total: contribs.length,
+      displayed: limitedContribs.length,
+      contributions: limitedContribs
+    });
+  } catch (error) {
+    return errorResult("Failed to get user contributions", error);
+  }
+}
+
+// src/tools/ro/whoami.ts
+function whoamiTool(server) {
+  const tool = server.tool(
+    "whoami",
+    "Get information about the currently logged in user",
+    {},
+    {
+      title: "Who am I",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async () => handleWhoamiTool()
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleWhoamiTool() {
+  try {
+    const bot = await getBot();
+    const userInfo = await promisifyBotMethod(
+      bot,
+      "whoami"
+    );
+    return jsonResult(userInfo);
+  } catch (error) {
+    return errorResult("Failed to get current user info", error);
+  }
+}
+
+// src/tools/ro/whois.ts
+import { z as z15 } from "zod";
+function whoisTool(server) {
+  const tool = server.tool(
+    "whois",
+    "Get information about a specific user",
+    {
+      username: z15.string().describe("Username to look up")
+    },
+    {
+      title: "Whois",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ username }) => handleWhoisTool(username)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleWhoisTool(username) {
+  try {
+    const bot = await getBot();
+    const userInfo = await promisifyBotMethod(
+      bot,
+      "whois",
+      username
+    );
+    if (userInfo.missing) {
+      return errorResult(`User "${username}" not found.`);
+    }
+    return jsonResult(userInfo);
+  } catch (error) {
+    return errorResult("Failed to get user info", error);
+  }
+}
+
+// src/tools/ro/whoare.ts
+import { z as z16 } from "zod";
+function whoareTool(server) {
+  const tool = server.tool(
+    "whoare",
+    "Get information about multiple wiki users",
+    {
+      usernames: z16.array(z16.string()).describe("Array of usernames to query")
+    },
+    {
+      title: "Who are",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async (params) => handleWhoareTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleWhoareTool(params) {
+  try {
+    const bot = await getBot();
+    const users = await promisifyBotMethod(
+      bot,
+      "whoare",
+      params.usernames
+    );
+    return jsonResult(users);
+  } catch (error) {
+    return errorResult("Failed to get user information", error);
+  }
+}
+
+// src/tools/ro/get-images.ts
+import { z as z17 } from "zod";
+function getImagesTool(server) {
+  const tool = server.tool(
+    "get-images",
+    "Get list of images starting from a specific name",
+    {
+      startFrom: z17.string().optional().default("").describe("Start from this image name"),
+      limit: z17.number().optional().default(50).describe("Maximum number of images to return")
+    },
+    {
+      title: "Get images",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ startFrom, limit }) => handleGetImagesTool(startFrom, limit)
+  );
+  tool.update({ outputSchema: { total: z17.number(), limit: z17.number(), startFrom: z17.string(), images: z17.array(z17.record(z17.unknown())) } });
+  return tool;
+}
+async function handleGetImagesTool(startFrom, limit) {
+  try {
+    const bot = await getBot();
+    const images = await new Promise((resolve, reject) => {
+      bot.getImages(startFrom, (err, ...args) => {
+        if (err) {
+          reject(err);
+        } else {
+          const imgs = args[0];
+          resolve(Array.isArray(imgs) ? imgs : []);
+        }
+      });
+    });
+    const limitedImages = images.slice(0, limit);
+    return jsonResult({
+      total: images.length,
+      limit,
+      startFrom,
+      images: limitedImages
+    });
+  } catch (error) {
+    return errorResult("Failed to get images", error);
+  }
+}
+
+// src/tools/ro/get-images-from-article.ts
+import { z as z18 } from "zod";
+function getImagesFromArticleTool(server) {
+  const tool = server.tool(
+    "get-images-from-article",
+    "Get all images embedded in a specific article",
+    {
+      title: z18.union([z18.string(), z18.number()]).describe("Article title or page ID")
+    },
+    {
+      title: "Get images from article",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title }) => handleGetImagesFromArticleTool(title)
+  );
+  tool.update({ outputSchema: { title: z18.string(), images: z18.array(z18.record(z18.unknown())), count: z18.number() } });
+  return tool;
+}
+async function handleGetImagesFromArticleTool(title) {
+  try {
+    const bot = await getBot();
+    const images = await promisifyBotMethod(
+      bot,
+      "getImagesFromArticle",
+      title
+    );
+    return jsonResult({
+      title,
+      images,
+      count: images.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get images from article", error);
+  }
+}
+
+// src/tools/ro/get-image-usage.ts
+import { z as z19 } from "zod";
+function getImageUsageTool(server) {
+  const tool = server.tool(
+    "get-image-usage",
+    "Get all pages that use a specific image",
+    {
+      filename: z19.string().describe("Image filename with File: prefix")
+    },
+    {
+      title: "Get image usage",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ filename }) => handleGetImageUsageTool(filename)
+  );
+  tool.update({ outputSchema: { filename: z19.string(), pages: z19.array(z19.record(z19.unknown())), count: z19.number() } });
+  return tool;
+}
+async function handleGetImageUsageTool(filename) {
+  try {
+    const bot = await getBot();
+    const pages = await promisifyBotMethod(
+      bot,
+      "getImageUsage",
+      filename
+    );
+    return jsonResult({
+      filename,
+      pages,
+      count: pages.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get image usage", error);
+  }
+}
+
+// src/tools/ro/get-image-info.ts
+import { z as z20 } from "zod";
+function getImageInfoTool(server) {
+  const tool = server.tool(
+    "get-image-info",
+    "Get detailed information about an image file",
+    {
+      filename: z20.string().describe("Image filename with File: prefix")
+    },
+    {
+      title: "Get image info",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ filename }) => handleGetImageInfoTool(filename)
+  );
+  tool.update({ outputSchema: { filename: z20.string(), info: z20.record(z20.unknown()) } });
+  return tool;
+}
+async function handleGetImageInfoTool(filename) {
+  try {
+    const bot = await getBot();
+    const info = await promisifyBotMethod(
+      bot,
+      "getImageInfo",
+      filename
+    );
+    if (!info) {
+      return errorResult(`Image "${filename}" not found.`);
+    }
+    return jsonResult({
+      filename,
+      info
+    });
+  } catch (error) {
+    return errorResult("Failed to get image info", error);
+  }
+}
+
+// src/tools/ro/get-log.ts
+import { z as z21 } from "zod";
+function getLogTool(server) {
+  const tool = server.tool(
+    "get-log",
+    "Get log entries of a specific type",
+    {
+      type: z21.string().describe("Log type (e.g. delete, block, move)"),
+      start: z21.string().optional().default("").describe("Start timestamp (YYYYMMDDHHMMSS format)"),
+      limit: z21.number().optional().default(50).describe("Maximum number of entries to return")
+    },
+    {
+      title: "Get log entries",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ type, start, limit }) => handleGetLogTool(type, start, limit)
+  );
+  tool.update({ outputSchema: { type: z21.string(), start: z21.string(), limit: z21.number(), total: z21.number(), displayed: z21.number(), entries: z21.array(z21.record(z21.unknown())) } });
+  return tool;
+}
+async function handleGetLogTool(type, start, limit) {
+  try {
+    const bot = await getBot();
+    const entries = await new Promise((resolve, reject) => {
+      bot.getLog(type, start, (err, ...args) => {
+        if (err) {
+          reject(err);
+        } else {
+          const ents = args[0];
+          resolve(Array.isArray(ents) ? ents : []);
+        }
+      });
+    });
+    const limitedEntries = entries.slice(0, limit);
+    return jsonResult({
+      type,
+      start,
+      limit,
+      total: entries.length,
+      displayed: limitedEntries.length,
+      entries: limitedEntries
+    });
+  } catch (error) {
+    return errorResult("Failed to get log entries", error);
+  }
+}
+
+// src/tools/ro/expand-templates.ts
+import { z as z22 } from "zod";
+function expandTemplatesTool(server) {
+  return server.tool(
+    "expand-templates",
+    "Expand templates in wikitext",
+    {
+      text: z22.string().describe("Wikitext with templates to expand"),
+      title: z22.string().optional().describe("Context page title")
+    },
+    {
+      title: "Expand templates",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ text, title }) => handleExpandTemplatesTool(text, title)
+  );
+}
+async function handleExpandTemplatesTool(text, title) {
+  try {
+    const bot = await getBot();
+    const expandedXml = await promisifyBotMethod(
+      bot,
+      "expandTemplates",
+      text,
+      title || ""
+    );
+    if (expandedXml == null) {
+      return {
+        content: [{ type: "text", text: `Failed to expand templates for "${text}".` }],
+        isError: true
+      };
+    }
+    return {
+      content: [{ type: "text", text: expandedXml }]
+    };
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true
+    };
+  }
+}
+
+// src/tools/ro/parse.ts
+import { z as z23 } from "zod";
+function parseTool(server) {
+  return server.tool(
+    "parse",
+    "Parse wikitext to HTML",
+    {
+      text: z23.string().describe("Wikitext to parse"),
+      title: z23.string().optional().describe("Context page title")
+    },
+    {
+      title: "Parse wikitext",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ text, title }) => handleParseTool(text, title)
+  );
+}
+async function handleParseTool(text, title) {
+  try {
+    const bot = await getBot();
+    const callbackArgs = await promisifyBotMethod(
+      bot,
+      "parse",
+      text,
+      title || ""
+    );
+    const xml = callbackArgs[1] || "";
+    const images = Array.isArray(callbackArgs[2]) ? callbackArgs[2] : [];
+    const output = [
+      "Parsed XML structure:",
+      "",
+      xml,
+      "",
+      `Images found: ${images.length > 0 ? images.join(", ") : "none"}`
+    ].join("\n");
+    return {
+      content: [{ type: "text", text: output }]
+    };
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true
+    };
+  }
+}
+
+// src/tools/ro/get-recent-changes.ts
+import { z as z24 } from "zod";
+function getRecentChangesTool(server) {
+  const tool = server.tool(
+    "get-recent-changes",
+    "Get recent changes on the wiki",
+    {
+      start: z24.string().optional().describe("Start timestamp"),
+      limit: z24.number().optional().default(50).describe("Maximum number of changes to return")
+    },
+    {
+      title: "Get recent changes",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ start, limit }) => handleGetRecentChangesTool(start, limit)
+  );
+  tool.update({ outputSchema: { total: z24.number(), limit: z24.number(), start: z24.string(), changes: z24.array(z24.record(z24.unknown())) } });
+  return tool;
+}
+async function handleGetRecentChangesTool(start, limit = 50) {
+  try {
+    const bot = await getBot();
+    const changes = await new Promise((resolve, reject) => {
+      bot.getRecentChanges(start, (err, ...args) => {
+        if (err) {
+          reject(err);
+        } else {
+          const chgs = args[0];
+          resolve(Array.isArray(chgs) ? chgs : []);
+        }
+      });
+    });
+    const limitedChanges = changes.slice(0, limit);
+    return jsonResult({
+      total: changes.length,
+      limit,
+      start,
+      changes: limitedChanges
+    });
+  } catch (error) {
+    return errorResult("Failed to get recent changes", error);
+  }
+}
+
+// src/tools/ro/get-site-info.ts
+import { z as z25 } from "zod";
+function getSiteInfoTool(server) {
+  const tool = server.tool(
+    "get-site-info",
+    "Get site information from MediaWiki",
+    {
+      properties: z25.array(z25.string()).describe("List of site information properties to retrieve")
+    },
+    {
+      title: "Get site info",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ properties }) => handleGetSiteInfoTool(properties)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleGetSiteInfoTool(properties) {
+  try {
+    const bot = await getBot();
+    const info = await promisifyBotMethod(
+      bot,
+      "getSiteInfo",
+      properties
+    );
+    return jsonResult(info || {});
+  } catch (error) {
+    return errorResult("Failed to get site info", error);
+  }
+}
+
+// src/tools/ro/get-site-stats.ts
+function getSiteStatsTool(server) {
+  const tool = server.tool(
+    "get-site-stats",
+    "Get site statistics",
+    {},
+    {
+      title: "Get site stats",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async () => handleGetSiteStatsTool()
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleGetSiteStatsTool() {
+  try {
+    const bot = await getBot();
+    const stats = await promisifyBotMethod(
+      bot,
+      "getSiteStats"
+    );
+    return jsonResult(stats);
+  } catch (error) {
+    return errorResult("Failed to get site stats", error);
+  }
+}
+
+// src/tools/ro/get-mediawiki-version.ts
+import { z as z26 } from "zod";
+function getMediaWikiVersionTool(server) {
+  const tool = server.tool(
+    "get-mediawiki-version",
+    "Get MediaWiki version running on the server",
+    {},
+    {
+      title: "Get MediaWiki version",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async () => handleGetMediaWikiVersionTool()
+  );
+  tool.update({ outputSchema: { version: z26.string() } });
+  return tool;
+}
+async function handleGetMediaWikiVersionTool() {
+  try {
+    const bot = await getBot();
+    const version = await promisifyBotMethod(
+      bot,
+      "getMediaWikiVersion"
+    );
+    return jsonResult({ version });
+  } catch (error) {
+    return errorResult("Failed to get MediaWiki version", error);
+  }
+}
+
+// src/tools/ro/get-query-page.ts
+import { z as z27 } from "zod";
+function getQueryPageTool(server) {
+  const tool = server.tool(
+    "get-query-page",
+    "Get results from a query page (special page)",
+    {
+      name: z27.string().describe("Name of the query page")
+    },
+    {
+      title: "Get query page results",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ name }) => handleGetQueryPageTool(name)
+  );
+  tool.update({ outputSchema: { name: z27.string(), results: z27.array(z27.record(z27.unknown())), count: z27.number() } });
+  return tool;
+}
+async function handleGetQueryPageTool(name) {
+  try {
+    const bot = await getBot();
+    const results = await promisifyBotMethod(
+      bot,
+      "getQueryPage",
+      name
+    );
+    return jsonResult({
+      name,
+      results,
+      count: results.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get query page results", error);
+  }
+}
+
+// src/tools/ro/get-external-links.ts
+import { z as z28 } from "zod";
+function getExternalLinksTool(server) {
+  const tool = server.tool(
+    "get-external-links",
+    "Get all external links from an article",
+    {
+      title: z28.union([z28.string(), z28.number()]).describe("Article title or page ID")
+    },
+    {
+      title: "Get external links",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title }) => handleGetExternalLinksTool(title)
+  );
+  tool.update({ outputSchema: { title: z28.string(), links: z28.array(z28.record(z28.unknown())), count: z28.number() } });
+  return tool;
+}
+async function handleGetExternalLinksTool(title) {
+  try {
+    const bot = await getBot();
+    const links = await promisifyBotMethod(
+      bot,
+      "getExternalLinks",
+      title
+    );
+    return jsonResult({
+      title,
+      links: links.map((link) => link["*"]),
+      count: links.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get external links", error);
+  }
+}
+
+// src/tools/ro/get-backlinks.ts
+import { z as z29 } from "zod";
+function getBacklinksTool(server) {
+  const tool = server.tool(
+    "get-backlinks",
+    "Get all backlinks to a specific page",
+    {
+      title: z29.string().describe("Target page title to find backlinks for")
+    },
+    {
+      title: "Get backlinks",
+      readOnlyHint: true,
+      destructiveHint: false
+    },
+    async ({ title }) => handleGetBacklinksTool(title)
+  );
+  tool.update({ outputSchema: { target: z29.string(), backlinks: z29.array(z29.record(z29.unknown())), count: z29.number() } });
+  return tool;
+}
+async function handleGetBacklinksTool(title) {
+  try {
+    const bot = await getBot();
+    const backlinks = await promisifyBotMethod(
+      bot,
+      "getBacklinks",
+      title
+    );
+    return jsonResult({
+      target: title,
+      backlinks,
+      count: backlinks.length
+    });
+  } catch (error) {
+    return errorResult("Failed to get backlinks", error);
+  }
+}
+
+// src/tools/editing/edit.ts
+import { z as z30 } from "zod";
+function editTool(server) {
+  const tool = server.tool(
+    "edit",
+    "Replace the ENTIRE content of a wiki page (requires authentication). CRITICAL: This is a FULL replacement \u2014 content you provide becomes the complete page, not an addition. There is NO undelete/undo tool \u2014 any damage you cause must be manually reverted by a human. To add a category or make a small change, you MUST first call get-article to retrieve the current content, modify it as needed, then pass the FULL modified content here. For appending or prepending without fetching the full page first, use the append/prepend tools instead.",
+    {
+      title: z30.string().describe("Page title to edit"),
+      content: z30.string().describe("COMPLETE new wikitext for the ENTIRE page \u2014 not a snippet, not a prefix, not an appendage. This replaces everything. Always fetch the current content with get-article first, then modify and resubmit the full text."),
+      intent: z30.enum(["add", "revise", "delete"]).describe(
+        'Your editing intent: "add" = adding content (page should grow), "revise" = modifying content (small net change, must keep \u22653/4 of existing bytes), "delete" = removing significant content (page should shrink significantly)'
+      ),
+      summary: z30.string().describe("Edit summary describing what was changed and why"),
+      minor: z30.boolean().optional().default(false).describe("Mark as minor edit")
+    },
+    {
+      title: "Edit page",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleEditTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleEditTool(params) {
+  try {
+    const bot = await getBot();
+    await requireRead(params.title);
+    const currentContent = await promisifyBotMethod(bot, "getArticle", params.title, false);
+    if (currentContent != null) {
+      const currentBytes = Buffer.byteLength(currentContent, "utf8");
+      const proposedBytes = Buffer.byteLength(params.content, "utf8");
+      const delta = currentBytes - proposedBytes;
+      if (delta > 200) {
+        switch (params.intent) {
+          case "add":
+            if (proposedBytes < currentBytes) {
+              return errorResult(
+                `Size mismatch: intent is "add" but proposed (${proposedBytes} B) < current (${currentBytes} B). Add operations should not shrink the page. If you meant to remove content, use intent "delete".`
+              );
+            }
+            break;
+          case "revise":
+            if (proposedBytes < currentBytes * 3 / 4) {
+              return errorResult(
+                `Size mismatch: intent is "revise" but proposed (${proposedBytes} B) < 3/4 of current (${currentBytes} B, threshold ${Math.floor(currentBytes * 3 / 4)} B). Revise should keep most content intact. For larger removals, use intent "delete".`
+              );
+            }
+            break;
+          case "delete":
+            if (proposedBytes < currentBytes * 1 / 10) {
+              return errorResult(
+                `Size mismatch: intent is "delete" but proposed (${proposedBytes} B) < 1/10 of current (${currentBytes} B, threshold ${Math.floor(currentBytes / 10)} B). This looks like an accidental page wipe. If intentional, verify the content is correct and retry.`
+              );
+            }
+            break;
+        }
+      }
+    }
+    const prefixedSummary = `[nodemw-mcp.edit] ${params.summary}`;
+    const result = await promisifyBotMethod(
+      bot,
+      "edit",
+      params.title,
+      params.content,
+      prefixedSummary,
+      params.minor || false
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to edit page", error);
+  }
+}
+
+// src/tools/editing/append.ts
+import { z as z31 } from "zod";
+function appendTool(server) {
+  const tool = server.tool(
+    "append",
+    "Append content to the END of a wiki page without changing existing content (requires authentication). Safe for adding categories, interwiki links, or any content that belongs at the bottom of a page.",
+    {
+      title: z31.string().describe("Page title"),
+      content: z31.string().describe('Content to append to the end of the page (e.g., "\\n[[Category:MyCategory]]")'),
+      summary: z31.string().describe("Edit summary")
+    },
+    {
+      title: "Append to page",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleAppendTool(params)
+  );
+  tool.update({ outputSchema: { success: z31.boolean(), title: z31.string() } });
+  return tool;
+}
+async function handleAppendTool(params) {
+  try {
+    const bot = await getBot();
+    await requireRead(params.title);
+    const prefixedSummary = `[nodemw-mcp.append] ${params.summary}`;
+    await promisifyBotMethod(
+      bot,
+      "append",
+      params.title,
+      params.content,
+      prefixedSummary
+    );
+    return jsonResult({ success: true, title: params.title });
+  } catch (error) {
+    return errorResult("Failed to append to page", error);
+  }
+}
+
+// src/tools/editing/prepend.ts
+import { z as z32 } from "zod";
+function prependTool(server) {
+  const tool = server.tool(
+    "prepend",
+    "Prepend content to the TOP of a wiki page without changing existing content (requires authentication). Useful for adding notices, templates, or cleanup tags that belong at the top of a page.",
+    {
+      title: z32.string().describe("Page title to prepend to"),
+      content: z32.string().describe('Content to prepend to the top of the page (e.g., "{{Cleanup}}\\n")'),
+      summary: z32.string().describe("Edit summary")
+    },
+    {
+      title: "Prepend to page",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handlePrependTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handlePrependTool(params) {
+  try {
+    const bot = await getBot();
+    await requireRead(params.title);
+    const prefixedSummary = `[nodemw-mcp.prepend] ${params.summary}`;
+    const result = await promisifyBotMethod(
+      bot,
+      "prepend",
+      params.title,
+      params.content,
+      prefixedSummary
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to prepend to page", error);
+  }
+}
+
+// src/tools/editing/move.ts
+import { z as z33 } from "zod";
+function moveTool(server) {
+  const tool = server.tool(
+    "move",
+    "Move (rename) a wiki page \u2014 changes the page title and creates a redirect from the old name (requires authentication). The old page title becomes a redirect to the new title. All page history moves with the page.",
+    {
+      from: z33.string().describe("Current/existing page title to rename"),
+      to: z33.string().describe("New target page title \u2014 must not already exist (unless moving to overwrite)"),
+      summary: z33.string().describe("Reason for the move (visible in move log)")
+    },
+    {
+      title: "Move page",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleMoveTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleMoveTool(params) {
+  try {
+    const bot = await getBot();
+    await requireRead(params.from);
+    const prefixedSummary = `[nodemw-mcp.move] ${params.summary}`;
+    const result = await promisifyBotMethod(
+      bot,
+      "move",
+      params.from,
+      params.to,
+      prefixedSummary
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to move page", error);
+  }
+}
+
+// src/tools/editing/delete.ts
+import { z as z34 } from "zod";
+function deleteTool(server) {
+  const tool = server.tool(
+    "delete",
+    "PERMANENTLY delete a wiki page (requires authentication). CRITICAL: This action is IRREVERSIBLE \u2014 there is NO undelete/undo tool available. Any deletion must be manually restored by a human administrator. Only delete a page when the user explicitly asks for it. Always verify the title is correct before proceeding.",
+    {
+      title: z34.string().describe("Exact page title to permanently delete \u2014 double-check this is correct"),
+      reason: z34.string().describe("Detailed reason for deletion (visible in deletion log)")
+    },
+    {
+      title: "Delete page",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleDeleteTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleDeleteTool(params) {
+  try {
+    const bot = await getBot();
+    await requireRead(params.title);
+    const prefixedReason = `[nodemw-mcp.delete] ${params.reason}`;
+    const result = await promisifyBotMethod(
+      bot,
+      "delete",
+      params.title,
+      prefixedReason
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to delete page", error);
+  }
+}
+
+// src/tools/editing/protect.ts
+import { z as z35 } from "zod";
+function protectTool(server) {
+  const tool = server.tool(
+    "protect",
+    'Protect or unprotect a wiki page to restrict editing/moving (requires authentication). CRITICAL: Protection can lock out legitimate editors \u2014 only protect pages when there is a clear need (ongoing vandalism, edit war, high-risk template, policy page). To remove protection, set level to "all". Available levels: "all" (anyone), "autoconfirmed" (trusted users), "sysop" (admins only).',
+    {
+      title: z35.string().describe("Page title to protect or unprotect"),
+      protections: z35.array(
+        z35.object({
+          type: z35.enum(["edit", "move"]).describe('Action to restrict: "edit" or "move"'),
+          level: z35.enum(["all", "autoconfirmed", "sysop"]).optional().default("all").describe(
+            'Who can perform this action: "all" = no restriction, "autoconfirmed" = trusted users only, "sysop" = admins only'
+          ),
+          expiry: z35.string().optional().describe('How long protection lasts (e.g. "1 day", "1 week", "infinite"). Default is indefinite.')
+        })
+      ).describe('Protection rules \u2014 typically one entry for "edit" and optionally one for "move". Example: [{type:"edit",level:"sysop",expiry:"1 week"}]'),
+      reason: z35.string().optional().describe("Reason for changing protection, visible in the page log"),
+      cascade: z35.boolean().optional().default(false).describe("If true, transcluded templates/pages inherit this protection. Only works with full sysop protection on edit. Use with caution.")
+    },
+    {
+      title: "Protect page",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleProtectTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleProtectTool(params) {
+  try {
+    const bot = await getBot();
+    await requireRead(params.title);
+    const options = {};
+    if (params.reason) {
+      options.reason = `[nodemw-mcp.protect] ${params.reason}`;
+    }
+    if (params.cascade) {
+      options.cascade = params.cascade;
+    }
+    const result = await promisifyBotMethod(
+      bot,
+      "protect",
+      params.title,
+      params.protections,
+      options
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to protect page", error);
+  }
+}
+
+// src/tools/editing/purge.ts
+import { z as z36 } from "zod";
+function purgeTool(server) {
+  const tool = server.tool(
+    "purge",
+    "Purge the server-side cache for one or more wiki pages (requires authentication). Forces MediaWiki to regenerate the page from current wikitext. This is a safe, non-destructive action.",
+    {
+      titles: z36.union([z36.string(), z36.array(z36.string())]).describe("Page title(s) or category name to purge")
+    },
+    {
+      title: "Purge pages",
+      readOnlyHint: false,
+      destructiveHint: false
+    },
+    async (params) => handlePurgeTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handlePurgeTool(params) {
+  try {
+    const bot = await getBot();
+    const result = await promisifyBotMethod(
+      bot,
+      "purge",
+      params.titles
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to purge pages", error);
+  }
+}
+
+// src/tools/editing/send-email.ts
+import { z as z37 } from "zod";
+function sendEmailTool(server) {
+  const tool = server.tool(
+    "send-email",
+    "Send an ACTUAL email to a wiki user via the wiki's built-in email system (requires authentication). CRITICAL: This sends a real email to the user's registered address \u2014 it is NOT a simulation. The recipient will see it came from the authenticated bot operator's wiki account. Abuse (spam, harassment, unsolicited messages) WILL result in the bot account being blocked. ONLY use this when the human user has explicitly asked you to send an email.",
+    {
+      username: z37.string().describe("Target wiki username \u2014 email goes to their registered email address"),
+      subject: z37.string().describe("Email subject line \u2014 be clear and professional, no misleading subjects"),
+      text: z37.string().describe("Plain text email body \u2014 will be delivered as-is to the recipient's inbox")
+    },
+    {
+      title: "Send email",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleSendEmailTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleSendEmailTool(params) {
+  try {
+    const bot = await getBot();
+    const result = await promisifyBotMethod(
+      bot,
+      "sendEmail",
+      params.username,
+      params.subject,
+      params.text
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to send email", error);
+  }
+}
+
+// src/tools/editing/upload.ts
+import { z as z38 } from "zod";
+function uploadTool(server) {
+  const tool = server.tool(
+    "upload",
+    "Upload a file to the wiki (requires authentication). CRITICAL: If a file with the same name already exists, it WILL BE OVERWRITTEN. Ensure you have the right to upload the content. Use only when explicitly requested.",
+    {
+      filename: z38.string().describe('Destination filename on wiki (e.g., "MyImage.png") \u2014 existing file will be overwritten!'),
+      content: z38.string().describe("File content encoded as base64 string"),
+      comment: z38.string().optional().describe("Upload comment describing the file")
+    },
+    {
+      title: "Upload file",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleUploadTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleUploadTool(params) {
+  try {
+    const bot = await getBot();
+    const fileContent = Buffer.from(params.content, "base64");
+    const comment = params.comment ? `[nodemw-mcp.upload] ${params.comment}` : "[nodemw-mcp.upload] File upload";
+    const result = await promisifyBotMethod(
+      bot,
+      "upload",
+      params.filename,
+      fileContent,
+      comment
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to upload file", error);
+  }
+}
+
+// src/tools/editing/upload-by-url.ts
+import { z as z39 } from "zod";
+function uploadByUrlTool(server) {
+  const tool = server.tool(
+    "upload-by-url",
+    "Upload a file to the wiki by downloading it from a URL (requires authentication). CRITICAL: If a file with the same name already exists, it WILL BE OVERWRITTEN. Ensure you have the right to upload the content from the source URL.",
+    {
+      filename: z39.string().describe('Destination filename on wiki (e.g., "Diagram.png") \u2014 existing file will be overwritten!'),
+      url: z39.string().url().describe("Source URL to download the file from \u2014 must be publicly accessible"),
+      summary: z39.string().optional().describe("Upload summary")
+    },
+    {
+      title: "Upload file by URL",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleUploadByUrlTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleUploadByUrlTool(params) {
+  try {
+    const bot = await getBot();
+    const prefixedSummary = params.summary ? `[nodemw-mcp.upload-by-url] ${params.summary}` : "[nodemw-mcp.upload-by-url] File upload from URL";
+    const result = await promisifyBotMethod(
+      bot,
+      "uploadByUrl",
+      params.filename,
+      params.url,
+      prefixedSummary
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to upload file by URL", error);
+  }
+}
+
+// src/tools/editing/add-flow-topic.ts
+import { z as z40 } from "zod";
+function addFlowTopicTool(server) {
+  const tool = server.tool(
+    "add-flow-topic",
+    "Add a new Flow/Structured Discussions topic to a wiki talk page (requires authentication). Creates a publicly visible discussion thread on the wiki. Ensure the content is appropriate and relevant.",
+    {
+      title: z40.string().describe('Talk page title to add the topic to (e.g., "Talk:Main Page")'),
+      subject: z40.string().describe("Topic title/heading \u2014 should summarize the discussion topic"),
+      content: z40.string().describe("Topic body content in wikitext format")
+    },
+    {
+      title: "Add Flow topic",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleAddFlowTopicTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleAddFlowTopicTool(params) {
+  try {
+    const bot = await getBot();
+    const result = await promisifyBotMethod(
+      bot,
+      "addFlowTopic",
+      params.title,
+      params.subject,
+      params.content
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to add Flow topic", error);
+  }
+}
+
+// src/tools/editing/create-account.ts
+import { z as z41 } from "zod";
+function createAccountTool(server) {
+  const tool = server.tool(
+    "create-account",
+    "Create a NEW user account on the wiki (requires authentication). CRITICAL: This creates a real user account. Do NOT create accounts for yourself or without explicit user request. The account will be permanently registered on the wiki.",
+    {
+      username: z41.string().describe("Desired username for the new account \u2014 must follow wiki username rules"),
+      password: z41.string().describe("Password for the new account \u2014 use a strong, unique password")
+    },
+    {
+      title: "Create user account",
+      readOnlyHint: false,
+      destructiveHint: true
+    },
+    async (params) => handleCreateAccountTool(params)
+  );
+  tool.update({ outputSchema: {} });
+  return tool;
+}
+async function handleCreateAccountTool(params) {
+  try {
+    const bot = await getBot();
+    const result = await promisifyBotMethod(
+      bot,
+      "createAccount",
+      params.username,
+      params.password
+    );
+    return jsonResult(result);
+  } catch (error) {
+    return errorResult("Failed to create account", error);
+  }
+}
+
+// src/tools/index.ts
+var readToolRegistrars = [
+  getArticleTool,
+  searchTool,
+  getPagesInCategoryTool,
+  getCategoriesTool,
+  getUsersTool,
+  getAllPagesTool,
+  getPagesInNamespaceTool,
+  getPagesByPrefixTool,
+  getPagesTranscludingTool,
+  getArticleRevisionsTool,
+  getArticleCategoriesTool,
+  getArticlePropertiesTool,
+  getArticleInfoTool,
+  getUserContribsTool,
+  whoamiTool,
+  whoisTool,
+  whoareTool,
+  getImagesTool,
+  getImagesFromArticleTool,
+  getImageUsageTool,
+  getImageInfoTool,
+  getLogTool,
+  expandTemplatesTool,
+  parseTool,
+  getRecentChangesTool,
+  getSiteInfoTool,
+  getSiteStatsTool,
+  getMediaWikiVersionTool,
+  getQueryPageTool,
+  getExternalLinksTool,
+  getBacklinksTool
+];
+var writeToolRegistrars = [
+  editTool,
+  appendTool,
+  prependTool,
+  moveTool,
+  deleteTool,
+  protectTool,
+  purgeTool,
+  sendEmailTool,
+  uploadTool,
+  uploadByUrlTool,
+  addFlowTopicTool,
+  createAccountTool
+];
+function registerAllTools(server, includeWriteTools = true) {
+  const registrars = includeWriteTools ? [...readToolRegistrars, ...writeToolRegistrars] : readToolRegistrars;
+  const registeredTools = [];
+  for (const registrar of registrars) {
+    try {
+      registeredTools.push(registrar(server));
+    } catch (error) {
+      console.error(`Error registering tool: ${error.message}`);
+    }
+  }
+  return registeredTools;
+}
+
+// src/index.ts
+function parseCliArgs() {
+  const { values, positionals } = parseArgs({
+    options: {
+      server: { type: "string", short: "s" },
+      path: { type: "string" },
+      endpoint: { type: "string" },
+      user: { type: "string", short: "u" },
+      pass: { type: "string", short: "p" },
+      token: { type: "string" },
+      "dry-run": { type: "boolean" }
+    },
+    strict: false,
+    allowPositionals: true
+  });
+  const serverUrl = values.server ?? positionals[0] ?? process.env.NODEMW_MCP_SERVER;
+  if (!serverUrl) {
+    console.error("Error: target server is required (-s, positional arg, or NODEMW_MCP_SERVER env)");
+    process.exit(1);
+  }
+  let server;
+  let protocol;
+  let port;
+  try {
+    if (serverUrl.startsWith("http://") || serverUrl.startsWith("https://")) {
+      const url = new URL(serverUrl);
+      server = url.hostname;
+      protocol = url.protocol.replace(":", "");
+      if (url.port) {
+        port = parseInt(url.port, 10);
+      }
+    } else {
+      server = serverUrl;
+    }
+  } catch {
+    server = serverUrl;
+  }
+  const pathFromEnv = process.env.NODEMW_MCP_ENDPOINT_PATH;
+  const pathExplicit = !!(values.path ?? values.endpoint ?? pathFromEnv);
+  return {
+    config: {
+      server,
+      protocol,
+      port,
+      path: values.path ?? values.endpoint ?? pathFromEnv ?? "/w",
+      username: values.user ?? process.env.NODEMW_MCP_MW_USER,
+      password: values.pass ?? process.env.NODEMW_MCP_MW_PASS,
+      token: values.token,
+      dryRun: values["dry-run"]
+    },
+    pathExplicit
+  };
+}
+async function main() {
+  const { config, pathExplicit } = parseCliArgs();
+  if (!pathExplicit) {
+    try {
+      config.path = await autoDetectPath(config);
+      console.error(`Auto-detected API path: ${config.path}`);
+    } catch (err) {
+      console.error("Error:", err.message);
+      process.exit(1);
+    }
+  }
+  initServerConfig(config);
+  try {
+    await initBot(config);
+  } catch (err) {
+    console.error("Error:", err.message);
+    process.exit(1);
+  }
+  const bot = getBot();
+  let siteInfo;
+  try {
+    const info = await promisifyBotMethod(bot, "getSiteInfo", ["general"]);
+    const general = info?.general;
+    if (general) {
+      siteInfo = {
+        sitename: general.sitename || "Unknown",
+        base: general.base || "",
+        generator: general.generator || "MediaWiki"
+      };
+    }
+  } catch {
+    console.error("Warning: Could not fetch site info for server description.");
+  }
+  const auth = isAuthenticated();
+  const server = createServer(siteInfo, auth);
+  registerAllTools(server, auth);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  const protocol = config.protocol ?? "https";
+  const endpoint = `${protocol}://${config.server}${config.path}/api.php`;
+  const sitename = siteInfo?.sitename ?? config.server;
+  console.error(`Ready to operate on "${sitename}" <${endpoint}>`);
+}
+main().catch(console.error);