Model Context Protocol (MCP)

Connect an MCP client using Streamable HTTP to explore the ZIM archives in this library.

Configuration

Add this configuration to a client that supports Streamable HTTP:

{
  "mcpServers": {
    "gozim": {
      "type": "http",
      "url": "http://zim.tensin.org/mcp"
    }
  }
}

The MCP endpoint has no authentication or TLS of its own. Use a trusted network or a proxy providing authentication, TLS, and rate limiting.

Quick usage

Connect the client, list the archives to find their slugs, then search an archive or retrieve an article. Search uses a prebuilt fulltext index when available, otherwise it searches title prefixes.

Available tools

ToolArgumentsResult
list_archivesNoneArchive slugs, titles, languages, entry counts, and fulltext availability.
searcharchive, query, optional limitFulltext or title-prefix results. Limit defaults to 20; the maximum is 100.
get_articlearchive, path, optional max_bytes and offsetEntry content and MIME type, with UTF-8 or base64 encoding.
get_metadataarchiveArchive metadata including title, language, creator, date, and UUID.
main_pagearchive, optional max_bytes and offsetArchive home page path and content.

Content tools default to 100,000 bytes; max_bytes ranges from 4 to 1,000,000 and offset is a non-negative byte offset. Responses include pagination details.

Example questions