# Magnetz

> A torrent metadata search engine. Find magnet links, browse by category, and look up torrents by infohash.

Magnetz indexes torrent metadata including file lists, swarm health, seeders/leechers, and full magnet URIs. It provides
a REST API, an MCP server for AI assistants, and a web search interface.

## Docs

- [API Documentation](https://magnetz.eu/apis): REST API reference — search, get by sqid, get by infohash
- [MCP Server](https://magnetz.eu/mcp-server): Model Context Protocol server for AI clients
- [About](https://magnetz.eu/about): What Magnetz is
- [RSS Feed](https://magnetz.eu/rss): Latest 100 torrents as RSS 2.0

## Use via MCP

MCP server URL: https://magnetz.eu/mcp/magnetz

Tools:
- `search-magnets` — Search torrents by name or keyword. Returns up to 25 results with magnet links and swarm health.
- `get-magnet` — Retrieve full details for a torrent by its sqid (short alphanumeric URL ID).
- `get-magnet-by-infohash` — Look up a torrent by its 40-character hex SHA-1 info hash.

## Use via API

Base URL: https://magnetz.eu

- `GET /api/magnets/search?query=<keywords>` — Search torrents, 25 results per page
- `GET /api/magnets/<sqid>` — Get full torrent detail by sqid
- `GET /api/magnets/infohash/<hash>` — Get torrent detail by 40-char hex infohash

## Optional

- [Browse](https://magnetz.eu/browse): Browse by type, movies, tv, software, books, music, games, anime
- [Lists](https://magnetz.eu/lists): Curated public torrent collections
- [OpenAPI Spec](https://magnetz.eu/openapi.yaml): Machine-readable REST API spec (OpenAPI 3.1)