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
| Tool | Arguments | Result |
|---|---|---|
list_archives | None | Archive slugs, titles, languages, entry counts, and fulltext availability. |
search | archive, query, optional limit | Fulltext or title-prefix results. Limit defaults to 20; the maximum is 100. |
get_article | archive, path, optional max_bytes and offset | Entry content and MIME type, with UTF-8 or base64 encoding. |
get_metadata | archive | Archive metadata including title, language, creator, date, and UUID. |
main_page | archive, optional max_bytes and offset | Archive 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
- Which archives are available?
- Search the Wikipedia archive for solar energy and summarize the results.
- Show me the main page and metadata for this archive.