Connect your AI assistant to any MediaWiki wiki, or script it directly from the terminal. Search, read, and edit wiki content using natural language or the wiki CLI.

Works with: Claude Desktop, Claude Code, Cursor, ChatGPT, n8n, and any MCP-compatible tool. Also ships a wiki CLI for shell scripts and CI pipelines, see Use from the Terminal.

Once connected, just ask your AI:

Option A: Download pre-built binary (easiest)

Go to Releases and download for your platform.

Option B: Build from source (requires Go 1.24+)

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

Your wiki's API URL is usually:

Tip: Visit Special:Version on your wiki to find the exact API endpoint.

Pick your tool:

Works on Mac and Windows. No terminal needed after initial setup.

The fastest setup. One command and you're done.

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php"

Test it: Ask "Search the wiki for getting started"

Cursor has built-in MCP support. Open Cursor Settings > MCP and add a new server, or edit the config file directly:

ChatGPT connects via HTTP. You need to run the server on a machine ChatGPT can reach.

Requirements: ChatGPT Pro, Plus, Business, Enterprise, or Education account.

1. Start the server with HTTP mode:

   # Set your wiki URL
   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   
   # Generate a secure token
   export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
   echo "Save this token: $MCP_AUTH_TOKEN"
   
   # Start the server
   ./mediawiki-mcp-server -http :8080

2. In ChatGPT:

   • Go to Settings → Connectors → Advanced → Developer Mode
   • Add a new MCP connector
   • URL: http://your-server:8080 (must be publicly accessible)
   • Authentication: Bearer token → paste your token

3. Test it: Ask "Search the wiki for getting started"

For production: See Security Best Practices for HTTPS setup.

n8n connects via HTTP using the MCP Client Tool node.

1. Start the server with HTTP mode:

   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   export MCP_AUTH_TOKEN="your-secure-token"
   ./mediawiki-mcp-server -http :8080

2. In n8n:

   • Add an MCP Client Tool node
   • Transport: HTTP Streamable
   • URL: http://your-server:8080
   • Authentication: Bearer → your token

3. Enable for AI agents (add to n8n environment):

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
   

4. Connect the MCP Client Tool to an AI Agent node.

VS Code has built-in MCP support via Copilot Chat.

1. Open the Command Palette: Ctrl+Shift+P (Windows) or Cmd+Shift+P (Mac)
2. Type "MCP: Add Server" and select it
3. Choose "Stdio" as the transport type
4. Enter the path to the binary when prompted
5. Name the server: mediawiki

This creates a .vscode/mcp.json file. Add the environment variables:

{
  "servers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
      }
    }
  }
}

On Windows, use the .exe path with double backslashes.

Reload VS Code, then use the wiki tools through Copilot Chat.

Google's Agent Development Kit connects to MCP servers via stdio or Streamable HTTP.

import (
    "os/exec"
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

// Create MCP toolset for wiki access
wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: &mcp.CommandTransport{
        Command: exec.Command("/path/to/mediawiki-mcp-server"),
        Env: []string{
            "MEDIAWIKI_URL=https://your-wiki.com/api.php",
        },
    },
})

// Add to your agent
agent := llmagent.New(llmagent.Config{
    Name:     "wiki-agent",
    Model:    model,
    Toolsets: []tool.Set{wikiTools},
})

export MEDIAWIKI_URL="https://your-wiki.com/api.php"
./mediawiki-mcp-server -http :8080 -token "your-secret-token"

import (
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: mcp.NewStreamableHTTPClientTransport("http://localhost:8080"),
})

from google.adk.tools.mcp_tool import MCPToolset, StdioConnectionParams, StdioServerParameters

wiki_tools = MCPToolset(
    connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(
            command="/path/to/mediawiki-mcp-server",
            env={"MEDIAWIKI_URL": "https://your-wiki.com/api.php"},
        )
    )
)

from google.adk.tools.mcp_tool import MCPToolset, StreamableHTTPConnectionParams

wiki_tools = MCPToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="http://localhost:8080",
        headers={"Authorization": "Bearer your-secret-token"},
    )
)

The wiki CLI is a command-line companion to the MCP server. It shares the same API client, auth, and configuration. Reach for it when a prompt is overkill: shell pipelines, CI checks, batch edits, cron jobs.

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o ~/go/bin/wiki ./cmd/wiki

The CLI reads the same environment variables as the MCP server.

export MEDIAWIKI_URL="https://your-wiki.com/api.php"

# Optional, for write operations
export MEDIAWIKI_USERNAME="User@BotName"
export MEDIAWIKI_PASSWORD="your-bot-password"

wiki config         # verify setup

You can also override the URL per-invocation with --url.

Every command supports --json (machine-readable output) and --quiet (errors only).

# Pipe lint results into CI
wiki lint "Release Notes" --json > lint.json

# Find broken external links as structured data
wiki links broken --json | jq '.[] | select(.status >= 400)'

# Publish a Markdown file
wiki publish docs/onboarding.md --title "Onboarding"

# Cron-friendly health check
wiki audit --quiet --json > /tmp/wiki-health.json

Run wiki <command> --help for full flags.

Reading works without login on public wikis. Private/corporate wikis often require authentication for all operations, including reading. Editing always requires a bot password.

1. Log in to your wiki
2. Go to Special:BotPasswords (e.g., https://your-wiki.com/wiki/Special:BotPasswords)
3. Enter a bot name: mcp-assistant
4. Check these permissions:
   • ✅ Basic rights
   • ✅ Edit existing pages
5. Click Create and save the password (you won't see it again)

Claude Desktop / Cursor:

{
  "mcpServers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php",
        "MEDIAWIKI_USERNAME": "YourWikiUsername@mcp-assistant",
        "MEDIAWIKI_PASSWORD": "your-bot-password-here"
      }
    }
  }
}

Claude Code CLI:

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php" \
  -e MEDIAWIKI_USERNAME="YourWikiUsername@mcp-assistant" \
  -e MEDIAWIKI_PASSWORD="your-bot-password-here"

📖 More examples: See WIKI_USE_CASES.md for detailed workflows by persona (content editors, documentation managers, developers).

• "What does our wiki say about deployment?"
• "Find all pages mentioning the API"
• "Show me the Getting Started guide"
• "List all pages in the Documentation category"
• "Give me a quick overview of the Configuration page" ✨
• "Get the content of Main Page, FAQ, and Setup all at once" ✨

• "Show me the sections of the Installation Guide"
• "Get the 'Troubleshooting' section from the FAQ page"
• "Find pages related to the API Reference"
• "What images are on the Product Overview page?"

• "What pages were updated this week?"
• "Who edited the Release Notes page?"
• "Show me the diff between the last two versions"
• "Who are the most active editors this month?" ✨
• "Which pages get edited most frequently?" ✨

• "Are there broken links on this page?"
• "Find orphaned pages with no links to them"
• "Check terminology consistency in the Product category"
• "Find pages similar to the Installation Guide" ✨
• "Compare how 'API version' is documented across pages" ✨
• "Find pages not updated in the last 90 days" ✨

• "Rename 'Old Guide' to 'Updated Guide'"
• "Add category 'API' to the Integration page"
• "Remove the 'Deprecated' category from this page"

• "Strike out John Smith on the Team page"
• "Replace 'version 2.0' with 'version 3.0' on Release Notes"
• "Make 'API Gateway' bold on the Architecture page"

• "Upload this image from URL to the wiki"
• "Add the logo from https://example.com/logo.png as Company_Logo.png"

• "Search for 'budget' in File:Annual-Report.pdf"
• "Find mentions of 'API' in the changelog.txt file"

Note: PDF search requires poppler-utils installed. See PDF Search Setup.

• "Convert this README to wiki format"
• "Transform my release notes from Markdown to MediaWiki"
• "Convert with Tieto branding and CSS" (use theme="tieto", add_css=true)

Themes:

• tieto - Tieto brand colors (Hero Blue headings, yellow code highlights)
• neutral - Clean output without custom colors (default)
• dark - Dark mode optimized

• "Who are the wiki admins?"
• "List all bot accounts"

"MEDIAWIKI_URL environment variable is required" → Check your config file has the correct path and URL.

"authentication failed" → Check username format: WikiUsername@BotName → Verify bot password hasn't expired → Ensure bot has required permissions

"page does not exist" → Page titles are case-sensitive. Check the exact title on your wiki.

Tools not appearing in Claude/Cursor → Restart the application after config changes.

ChatGPT can't connect → Ensure your server is publicly accessible (not just localhost) → Check the bearer token matches exactly

"PDF search requires 'pdftotext'" → Install poppler-utils for your platform (see PDF Search Setup)

PDF search requires the pdftotext tool from poppler-utils. Text file search (TXT, MD, CSV, etc.) works without any dependencies.

Windows alternative: Download binaries from poppler-windows releases and add to PATH.

Verify installation:

pdftotext -v

Works with any wiki: Wikipedia, Fandom, corporate wikis, or any MediaWiki installation.

For ChatGPT, n8n, and remote access, the server supports HTTP transport.

# Basic HTTP server
./mediawiki-mcp-server -http :8080

# With authentication
./mediawiki-mcp-server -http :8080 -token "your-secret-token"

# Restrict to specific origins
./mediawiki-mcp-server -http :8080 -token "secret" \
  -origins "https://chat.openai.com,https://n8n.example.com"

# Bind to localhost only (for use behind reverse proxy)
./mediawiki-mcp-server -http 127.0.0.1:8080 -token "secret"

When exposing the server over HTTP:

./mediawiki-mcp-server -http :8080 -token "$(openssl rand -hex 32)"

Example nginx configuration:

server {
    listen 443 ssl;
    server_name mcp.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

./mediawiki-mcp-server -http :8080 -token "secret" \
  -origins "https://chat.openai.com"

When running in HTTP mode, these endpoints are available:

Use /health and /ready for container orchestration:

# Kubernetes example
livenessProbe:
  httpGet:
    path: /health
    port: 8080
readinessProbe:
  httpGet:
    path: /ready
    port: 8080

Get a list of all available tools:

curl http://localhost:8080/tools | jq '.categories | keys'

Check circuit breaker and request deduplication status:

curl http://localhost:8080/status
# Returns: {"circuit_breaker":{"state":"closed",...},"inflight_requests":0}

"What does the wiki say about deployment?"
→ Searches, reads top result, returns content + remaining hits as summaries

"What is the API Reference page about?"
→ Returns intro section, categories, section list, and metadata

"Get the content of Main Page, FAQ, and Getting Started"
→ Returns all three pages in a single API request

"Find pages not updated in 90 days"
→ Returns stale pages sorted oldest-first with days since last edit

"Find pages similar to the API Reference page"
→ Returns similarity scores, common terms, and linking recommendations

"Compare how 'timeout' is described across all pages"
→ Returns page mentions with context snippets and value mismatches

{
  "revision": {
    "old_revision": 1234,
    "new_revision": 1235,
    "diff_url": "https://wiki.../index.php?diff=1235&oldid=1234"
  },
  "undo": {
    "instruction": "To undo: use wiki URL or revert to revision 1234",
    "wiki_url": "https://wiki.../index.php?title=...&action=edit&undo=1235"
  }
}

"Rename 'Old Guide' to 'Updated Guide'"
→ Moves page, creates redirect, optionally moves talk page

"Add category 'API' and remove category 'Deprecated' from this page"
→ Modifies categories without touching page content

Input:  "# Hello\n**bold** and *italic*"
Output: "= Hello =\n'''bold''' and ''italic''"

New to this? Check out the Tieto Setup Guide for step-by-step instructions that assume no technical knowledge.

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://wiki.software-innovation.com/api.php" \
  -e MEDIAWIKI_USERNAME="your.email@tietoevry.com#wiki-MCP" \
  -e MEDIAWIKI_PASSWORD="your-bot-password-here"

{
  "mcpServers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://wiki.software-innovation.com/api.php",
        "MEDIAWIKI_USERNAME": "your.email@tietoevry.com#wiki-MCP",
        "MEDIAWIKI_PASSWORD": "your-bot-password-here"
      }
    }
  }
}

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

Requires Go 1.24+

# Unit tests
make test

# With coverage
make test-cover

# Lint
make lint

Integration tests run against a real MediaWiki instance:

# Start MediaWiki container
docker-compose -f docker-compose.test.yml up -d

# Wait for MediaWiki to be ready (about 60 seconds)
# Run integration tests
go test -tags=integration ./wiki/...

# Stop and clean up
docker-compose -f docker-compose.test.yml down -v

Integration tests can also be triggered manually via GitHub Actions.

mediawiki-mcp-server/
├── main.go                    # Server entry point, HTTP transport
├── main_test.go               # Server tests
├── wiki_editing_guidelines.go # AI guidance for editing
├── docker-compose.test.yml    # Integration test environment
│
├── .github/workflows/
│   ├── ci.yml                 # Unit tests, lint, build
│   └── integration.yml        # Integration tests (manual trigger)
│
├── scripts/
│   └── LocalSettings.php      # MediaWiki config for tests
│
├── tools/                     # MCP tool definitions
│   ├── definitions.go         # Tool schemas and metadata
│   ├── handlers.go            # Tool request handlers
│   └── registry.go            # Tool registration
│
├── wiki/                      # MediaWiki API client
│   ├── client.go              # HTTP client with auth
│   ├── config.go              # Configuration management
│   ├── types.go               # Request/response types
│   ├── errors.go              # Error handling
│   ├── read.go                # Page reading operations
│   ├── write.go               # Page editing operations
│   ├── search.go              # Search functionality
│   ├── methods.go             # Core API methods
│   ├── history.go             # Revision history
│   ├── categories.go          # Category operations
│   ├── users.go               # User management
│   ├── links.go               # Link analysis
│   ├── quality.go             # Content quality checks
│   ├── audit.go               # Wiki health audits
│   ├── similarity.go          # Content similarity detection
│   ├── pdf.go                 # PDF text extraction
│   ├── security.go            # Input sanitization, SSRF protection
│   ├── integration_test.go    # Integration tests (build tag)
│   └── *_test.go              # Unit tests
│
├── converter/                 # Markdown to MediaWiki converter
│   ├── converter.go           # Conversion logic
│   ├── converter_test.go      # Tests
│   └── themes.go              # Theme definitions (tieto, neutral, dark)
│
├── cmd/
│   └── benchmark/             # Performance benchmarking
│       └── main.go
│
├── ARCHITECTURE.md            # System design documentation
├── CONTRIBUTING.md            # Contribution guidelines
├── SECURITY.md                # Security policy
├── WIKI_USE_CASES.md          # Usage examples by persona
└── README.md

If this server saved you time, consider giving it a ⭐ on GitHub. It helps others discover the project.

Check out my other MCP servers:

Server	Description	Stars
gleif-mcp-server	Access GLEIF LEI database. Look up company identities, verify legal entities.
miro-mcp-server	Control Miro whiteboards with AI. Boards, diagrams, mindmaps, and more.
nordic-registry-mcp-server	Access Nordic business registries. Look up companies across Norway, Denmark, Finland, Sweden.
productplan-mcp-server	Talk to your ProductPlan roadmaps. Query OKRs, ideas, launches.
tilbudstrolden-mcp	Nordic grocery deal hunting. Find offers, plan meals, track spending.
mcp-servercard-go	Go library for SEP-2127 Server Cards. Pre-connect discovery for MCP servers.

MIT License

• Built with Go MCP SDK
• Powered by MediaWiki API