BEST for adding formatting markup to specific text.

USE WHEN: User says "strike out X", "cross out the name", "make X bold", "italicize Y", "mark as code".

NOT FOR: Replacing text (use mediawiki_find_replace).

PARAMETERS:

• title: Page name (required)

• text: Text to format (required)

• format: Formatting type (required):

  • "strikethrough": text (for removed/former items)

  • "bold": '''text'''

  • "italic": ''text''

  • "underline": text

  • "code": text

• all: Format all occurrences (default false)

• preview: Preview changes (default true)

• summary: Edit summary

RETURNS: Preview of formatting applied. Set preview=false to apply. Includes revision ID, diff URL, and undo instructions.

Run comprehensive wiki health audit with multiple checks.

USE WHEN: User asks "run health check", "audit the wiki", "check wiki quality".

PARAMETERS:

• checks: Array of checks to run (default all):

  • "links": Broken internal links

  • "terminology": Glossary violations

  • "orphans": Unlinked pages

  • "activity": Recent changes

  • "external": Broken external links (slow)

• limit: Max items per check (default 20)

RETURNS: Health score (0-100), detailed results per check, and recommendations.

Retrieve content from MULTIPLE pages in a single API call.

USE WHEN: You need content from 2+ pages. Much faster than individual mediawiki_get_page calls.

NOT FOR: Single page (use mediawiki_get_page). Not for metadata only (use mediawiki_batch_get_pages_info).

PARAMETERS:

• titles: Array of page titles (required, max 50)

• format: "wikitext" (default) or "html"

RETURNS: Page content for each title, with exists/missing status. Missing pages are reported, not errors.

Get metadata for MULTIPLE pages in a single API call.

USE WHEN: You need info (last edit, size, categories) for 2+ pages without their content.

NOT FOR: Single page (use mediawiki_get_page_info). Not for content (use mediawiki_batch_get_pages).

PARAMETERS:

• titles: Array of page titles (required, max 50)

RETURNS: Metadata (size, last edit, categories, protection) per page. Missing pages reported with exists=false.

Update text across MULTIPLE pages at once.

USE WHEN: User says "update everywhere", "fix on all pages", "change brand name across docs", "update in all documentation".

NOT FOR: Single page changes (use mediawiki_find_replace - more efficient).

PARAMETERS:

• find: Text to find (required)

• replace: Replacement text (required)

• pages: Array of specific pages (optional)

• category: Update all pages in category (optional)

• use_regex: Treat find as regex (default false)

• preview: Preview changes (ALWAYS use true first!)

• limit: Max pages to update (default 50)

• summary: Edit summary

WARNING: Always use preview=true first to verify matches before applying.

RETURNS: Changes per page. Set preview=false to apply all changes. Includes revision ID, diff URL, and undo instructions.

Verify external URL accessibility via HTTP requests.

USE WHEN: User asks "check if these links work", "find broken URLs", "verify external links".

NOT FOR: Finding broken internal wiki links (use mediawiki_find_broken_internal_links).

PARAMETERS:

• urls: Array of URLs to check (required, max 20)

• timeout: Request timeout in seconds (default 10)

RETURNS: URL status codes, response times, and broken link identification.

Scan pages for terminology violations against a glossary.

USE WHEN: User asks "check brand terminology", "find incorrect terms", "verify consistent naming".

PARAMETERS:

• pages: Array of pages to check (optional)

• category: Check all pages in category (optional)

• glossary_page: Wiki page with term mappings (default "Brand Terminology Glossary")

• exclude_code_blocks: Skip code blocks (default true)

• limit: Max pages (default 10)

RETURNS: Violations with page, line, wrong term, and correct term.

Find pages missing translations in specified languages.

USE WHEN: User asks "which pages need German translation", "find missing translations", "check language coverage".

PARAMETERS:

• languages: Array of language codes (required, e.g., ["de", "fr", "es"])

• base_pages: Specific pages to check (optional)

• category: Check pages in category (optional)

• pattern: Naming pattern - "subpages" (Page/de), "suffixes" (Page (de)), or "prefixes" (de:Page)

• limit: Max pages (default 50)

RETURNS: Missing translations grouped by language.

Compare two revisions and show the diff.

USE WHEN: User asks "what changed between versions", "show the diff", "compare old and new".

NOT FOR: Just listing revisions (use mediawiki_get_revisions). Not for comparing a topic across pages (use mediawiki_compare_topic).

PARAMETERS:

• from_rev: Source revision ID, OR

• from_title: Source page title (uses latest revision)

• to_rev: Target revision ID, OR

• to_title: Target page title

RETURNS: HTML-formatted diff showing additions (green) and deletions (red).

Compare how a topic is described across multiple pages.

USE WHEN: User asks "how is X described on different pages", "find inconsistencies about timeout", "compare definitions of Y".

NOT FOR: Comparing page revisions (use mediawiki_compare_revisions).

PARAMETERS:

• topic: Topic or term to compare (required)

• category: Limit to pages in category (optional)

• limit: Max pages to check (default 20)

RETURNS: Page mentions with context, detected value mismatches, and inconsistencies.

Convert Markdown text to MediaWiki markup. Use this tool when you need to transform Markdown-formatted content into wiki-compatible format before creating or editing wiki pages.

WHEN TO USE:

• User provides Markdown content to add to the wiki

• Converting documentation from GitHub/GitLab to wiki format

• Transforming README files for wiki publishing

• Preparing release notes written in Markdown

THEMES:

• "tieto": Tieto brand colors (Hero Blue #021e57 headings, yellow code highlights)

• "neutral": Clean output without custom colors (default)

• "dark": Dark mode optimized colors

OPTIONS:

• add_css: Include CSS styling block for branded appearance

• reverse_changelog: Reorder changelog entries newest-first

• prettify_checks: Replace plain checkmarks with emoji

EXAMPLE: Input: "# Hello\nbold and italic\n- item 1\n- item 2" Output: "= Hello =\n'''bold''' and ''italic''\n* item 1\n* item 2"

Create new pages or rewrite entire page content.

USE WHEN: User says "create a new page", "rewrite the entire About page", "replace all content".

NOT FOR: Simple text changes (use mediawiki_find_replace). Not for formatting (use mediawiki_apply_formatting).

PARAMETERS:

• title: Page name (required)

• content: New page content (required)

• section: Edit specific section only (optional)

• summary: Edit summary (required for good practice)

• minor: Mark as minor edit (default false)

• bot: Mark as bot edit (default false)

RETURNS: Includes revision ID, diff URL, and undo instructions.

WARNING: This overwrites entire page content unless section is specified.

Find internal wiki [[links]] pointing to non-existent pages.

USE WHEN: User asks "find broken wiki links", "check for dead internal links", "find [[links]] to missing pages".

NOT FOR: Checking external HTTP URLs (use mediawiki_check_links).

PARAMETERS:

• pages: Array of pages to scan (optional)

• category: Scan all pages in category (optional)

• limit: Max pages to scan (default 20)

RETURNS: Broken links with source page, line number, and context.

Find pages with no incoming links from other pages.

USE WHEN: User asks "find orphan pages", "which pages have no links", "find undiscoverable content".

PARAMETERS:

• namespace: Filter by namespace (default 0 = main)

• prefix: Filter by title prefix (optional)

• limit: Max orphans to return (default 50)

RETURNS: List of orphaned page titles.

PREFERRED for simple text changes on a single page.

USE WHEN: User says "replace X with Y", "fix the typo", "change the version number", "update the name".

NOT FOR: Creating/rewriting pages (use mediawiki_edit_page). Not for multi-page updates (use mediawiki_bulk_replace). Not for formatting (use mediawiki_apply_formatting).

PARAMETERS:

• title: Page name (required)

• find: Text to find (required)

• replace: Replacement text (required)

• all: Replace all occurrences (default false = first only)

• use_regex: Treat find as regex (default false)

• preview: Preview changes without saving (default true for safety)

• summary: Edit summary

RETURNS: Match count and preview of changes. Set preview=false to apply. Includes revision ID, diff URL, and undo instructions.

Find pages with similar content (potential duplicates or overlaps).

USE WHEN: User asks "find similar pages", "are there duplicates", "what pages overlap with X".

NOT FOR: Finding related pages by links (use mediawiki_get_related).

PARAMETERS:

• page: Source page name (required)

• category: Limit search to category (optional)

• min_score: Minimum similarity threshold 0-1 (default 0.1)

• limit: Max similar pages (default 10)

RETURNS: Similar pages with similarity scores and linking recommendations.

Get pages that link TO a specific page ("What links here").

USE WHEN: User asks "what links to X", "which pages reference the API", "show incoming links".

NOT FOR: Outgoing external links (use mediawiki_get_external_links).

PARAMETERS:

• title: Page name (required)

• namespace: Filter by namespace (optional)

• limit: Max backlinks (default 50)

• include_redirects: Include redirect pages (default false)

RETURNS: List of pages that link to the target page.

Get all pages that belong to a specific category.

USE WHEN: User asks "show pages in Documentation category", "list all tutorials", "what's in Category:API".

NOT FOR: Listing categories themselves (use mediawiki_list_categories).

PARAMETERS:

• category: Category name without "Category:" prefix (required)

• type: Filter by type - "page", "subcat", "file", or all (default)

• limit: Max members (default 50)

• continue_from: Pagination token

RETURNS: Page titles in the category.

Get all external URLs from a wiki page.

USE WHEN: User asks "what external links are on X", "show outgoing URLs", "list http links".

NOT FOR: Incoming wiki links (use mediawiki_get_backlinks). Not for verifying links work (use mediawiki_check_links).

PARAMETERS:

• title: Page name (required)

RETURNS: List of external URLs on the page.

Batch retrieve external URLs from multiple pages at once.

USE WHEN: User asks "get links from these 5 pages", "collect URLs from multiple articles".

NOT FOR: Single page (use mediawiki_get_external_links - more efficient).

PARAMETERS:

• titles: Array of page names (required, max 10)

RETURNS: External URLs grouped by source page.

Get all images and files used on a wiki page.

USE WHEN: User asks "what images are on X", "show files used in the article", "list media on this page".

PARAMETERS:

• title: Page name (required)

• limit: Max images (default 50)

RETURNS: Image titles, URLs, dimensions, and file sizes.

Retrieve full wiki page content.

USE WHEN: User says "show me the X page", "what's on the Main Page", "read the FAQ".

NOT FOR: Getting page structure/TOC (use mediawiki_get_sections). Not for searching content (use mediawiki_search_in_page). Not for metadata only (use mediawiki_get_page_info). If title not found, use mediawiki_resolve_title to handle typos and case sensitivity.

PARAMETERS:

• title: Page name (required)

• format: "wikitext" (default) or "html"

RETURNS: Page content in requested format. Large pages truncated at 25KB.

Get page metadata without content.

USE WHEN: User asks "when was X last edited", "who created the FAQ", "is the page protected".

NOT FOR: Getting page content (use mediawiki_get_page). Not for full edit history (use mediawiki_get_revisions).

PARAMETERS:

• title: Page name (required)

RETURNS: Last edit timestamp, page size, protection status, creator.

Get lead section + key metadata without loading the full page.

USE WHEN: User asks "what is X about", "quick overview of X", "summarize the X page". Much lighter than mediawiki_get_page for large pages.

NOT FOR: Full page content (use mediawiki_get_page). Not for specific sections (use mediawiki_get_sections with section parameter).

PARAMETERS:

• title: Page name (required)

RETURNS: Lead section (intro before first heading), page size, categories, section list, last edit timestamp.

Get recent changes across the entire wiki.

USE WHEN: User asks "what's been changed recently", "show wiki activity", "who's been editing".

NOT FOR: Single page history (use mediawiki_get_revisions). Not for user-specific edits (use mediawiki_get_user_contributions).

PARAMETERS:

• limit: Max changes (default 50)

• start, end: Time range (ISO 8601)

• namespace: Filter by namespace

• type: Filter by change type (edit, new, log)

• aggregate_by: Group results - "user", "page", or "type"

RETURNS: Recent changes with timestamps, users, and summaries. Aggregation returns counts.

Find pages related to a given page via links and categories.

USE WHEN: User asks "what pages are related to X", "show linked pages", "find associated content".

NOT FOR: Finding content-similar pages (use mediawiki_find_similar_pages for duplicate detection).

PARAMETERS:

• title: Page name (required)

• method: "categories" (default), "links", "backlinks", or "all"

• limit: Max related pages (default 20)

RETURNS: Related page titles with relationship type.

Get revision history for a specific page.

USE WHEN: User asks "who edited the FAQ", "show edit history of X", "when was this page last changed".

NOT FOR: Wiki-wide activity (use mediawiki_get_recent_changes). Not for comparing versions (use mediawiki_compare_revisions).

PARAMETERS:

• title: Page name (required)

• limit: Max revisions (default 50)

• start, end: Time range (ISO 8601)

• user: Filter by user

RETURNS: Revision list with timestamps, users, sizes, and edit summaries.

Get page section structure (TOC) or specific section content.

USE WHEN: User asks "what sections does X have", "show the table of contents", "get the Installation section".

NOT FOR: Full page content (use mediawiki_get_page).

PARAMETERS:

• title: Page name (required)

• section: Section index to retrieve content (optional; omit for TOC only)

• format: "wikitext" (default) or "html" (for section content)

RETURNS: Section headings with indices, or specific section content.

Find pages that haven't been edited in a specified number of days.

USE WHEN: User asks "find outdated pages", "which pages need review", "show stale content", "wiki hygiene check".

NOT FOR: Recent activity (use mediawiki_get_recent_changes). Not for orphaned pages (use mediawiki_find_orphaned_pages).

PARAMETERS:

• days: Staleness threshold in days (default 90)

• category: Limit to pages in this category (optional)

• namespace: Namespace to check (default 0 = main)

• limit: Max pages to return (default 50, max 200)

RETURNS: Stale pages sorted by last edit (oldest first), with days since edit and last editor.

Get all edits made by a specific user.

USE WHEN: User asks "what did John edit", "show user's contributions", "list edits by admin".

NOT FOR: Page-specific history (use mediawiki_get_revisions). Not for wiki-wide activity (use mediawiki_get_recent_changes).

PARAMETERS:

• user: Username (required)

• limit: Max contributions (default 50)

• start, end: Time range (ISO 8601)

• namespace: Filter by namespace

RETURNS: List of pages edited with timestamps and summaries.

Get information about the wiki itself.

USE WHEN: User asks "what wiki is this", "wiki statistics", "MediaWiki version".

PARAMETERS: None

RETURNS: Wiki name, version, statistics (pages, users, edits).

List all categories in the wiki.

USE WHEN: User asks "what categories exist", "show all categories", "list available categories".

NOT FOR: Getting pages in a category (use mediawiki_get_category_members).

PARAMETERS:

• prefix: Filter by category name prefix (optional)

• limit: Max categories (default 50)

• continue_from: Pagination token

RETURNS: Category names and page counts.

List wiki pages with optional prefix filter.

USE WHEN: User asks "list all pages", "show pages starting with API", "what pages exist".

NOT FOR: Finding pages by content (use mediawiki_search).

PARAMETERS:

• prefix: Filter by title prefix (optional)

• namespace: Namespace ID (default 0 = main)

• limit: Max pages (default 50)

• continue_from: Pagination token from previous response

RETURNS: Page titles and IDs.

List wiki users with optional group filtering.

USE WHEN: User asks "who are the admins", "list all users", "show active editors".

PARAMETERS:

• group: Filter by group - "sysop" (admins), "bureaucrat", "bot" (optional)

• active_only: Only show recently active users (default false)

• limit: Max users (default 50)

• continue_from: Pagination token

RETURNS: User names, groups, edit counts, and registration dates.

Add or remove categories from a page without editing the full content.

USE WHEN: User says "add category X to this page", "remove this from category Y", "categorize this page".

NOT FOR: Listing categories (use mediawiki_list_categories). Not for viewing category members (use mediawiki_get_category_members).

PARAMETERS:

• title: Page name (required)

• add: Array of category names to add (without "Category:" prefix)

• remove: Array of category names to remove (without "Category:" prefix)

• preview: Preview changes without saving (default false)

• summary: Edit summary

RETURNS: Which categories were added, removed, already present, or not found. Includes revision ID, diff URL, and undo instructions.

Move (rename) a wiki page. Creates a redirect from the old title.

USE WHEN: User says "rename the page", "move X to Y", "change the page title".

NOT FOR: Editing page content (use mediawiki_edit_page or mediawiki_find_replace).

PARAMETERS:

• from: Current page title (required)

• to: New page title (required)

• reason: Reason for the move (optional)

• no_redirect: Don't create redirect from old title (default false)

• move_talk: Also move the talk page (default true)

• move_subpages: Also move subpages (default false)

RETURNS: Includes revision ID, diff URL, and undo instructions.

WARNING: Requires move permissions. Creates a redirect from the old title by default.

Parse wikitext and return rendered HTML.

USE WHEN: User wants to preview wikitext rendering, test markup syntax.

PARAMETERS:

• wikitext: Wikitext content to parse (required)

• title: Context page title for link resolution (optional)

RETURNS: Rendered HTML output.

RECOVERY tool when page not found due to case sensitivity or typos.

USE WHEN: User got "page not found" and suspects wrong capitalization or spelling. E.g., "module overview" should be "Module Overview".

NOT FOR: Finding pages about a topic (use mediawiki_search instead).

PARAMETERS:

• title: Approximate page name (required)

• fuzzy: Enable fuzzy matching for typos (default true)

• max_results: Max suggestions (default 5)

RETURNS: Suggested correct page titles with confidence scores.

Search ACROSS the entire wiki for pages containing specific text.

USE WHEN: User asks "find pages about X", "where is X documented", "search for X", or doesn't know which page contains information.

NOT FOR: Searching within a specific known page (use mediawiki_search_in_page instead).

PARAMETERS:

• query: Search text (required)

• limit: Max results (default 20)

RETURNS: Page titles, snippets with highlights, and relevance scores.

Search wiki AND read the top result(s) in a single call.

USE WHEN: User asks a question about wiki content. This is the fastest path from question to answer — eliminates the search-then-read round trip.

NOT FOR: Known page titles (use mediawiki_get_page directly). Not for listing search results without reading (use mediawiki_search).

PARAMETERS:

• query: Search text (required)

• read_count: How many top results to read (default 1, max 5)

• format: "wikitext" (default) or "html"

RETURNS: Full content of top result(s) plus remaining search hits as summaries.

Search for text within wiki-hosted files (PDFs, text files).

USE WHEN: User asks "search the PDF for X", "find X in the uploaded document".

NOT FOR: Searching wiki pages (use mediawiki_search or mediawiki_search_in_page).

PARAMETERS:

• filename: File name on wiki (required)

• query: Text to search for (required)

RETURNS: Matches with page numbers (for PDFs) or line numbers.

NOTE: Supports text-based PDFs and text files (TXT, MD, CSV, JSON, XML, HTML). Scanned/image PDFs require OCR and are not supported.

Search WITHIN a known page (not across wiki).

USE WHEN: User says "find X on page Y", "does page Y mention X", "search for X in the Configuration page".

NOT FOR: Finding which page contains info (use mediawiki_search instead).

PARAMETERS:

• title: Page name (required)

• query: Text to find (required)

• use_regex: Enable regex matching (optional)

• context_lines: Lines of context around matches (default 2)

RETURNS: Matches with line numbers and surrounding context.

Upload a file to the wiki from a URL or local path.

USE WHEN: User says "upload this image", "add file to wiki", "import document".

PARAMETERS:

• filename: Target filename on wiki (required)

• file_url: Source URL to fetch file from (one of file_url or file_path required)

• file_path: Local file path (alternative to file_url)

• text: File description page content (optional)

• comment: Upload comment (optional)

• ignore_warnings: Overwrite existing file (default false)

RETURNS: Upload status and file page URL. Includes revision ID, diff URL, and undo instructions.

NOTE: Requires authentication. URL must be publicly accessible.

SECURITY: Source URL must be on the MEDIAWIKI_UPLOAD_ALLOWED_DOMAINS env-var allowlist (fail-closed when unset). Private/internal IPs are blocked unconditionally. ignore_warnings=true overwrites existing files; the destructive-hint annotation is set so hosts that gate destructive operations will prompt before this runs.