# Magnetz — Full LLM Reference

> 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. No authentication is required for the API or
MCP server.

## Docs

- [API Documentation](https://magnetz.eu/apis): Full REST API reference
- [MCP Server](https://magnetz.eu/mcp-server): MCP server setup guide
- [OpenAPI Spec](https://magnetz.eu/openapi.yaml): Machine-readable spec (OpenAPI 3.1)
- [About](https://magnetz.eu/about): What Magnetz is
- [RSS Feed](https://magnetz.eu/rss): Latest 100 torrents

## Use via MCP

MCP server URL: https://magnetz.eu/mcp/magnetz
Transport: HTTP/SSE. No API key required.

### Tool: search-magnets
Input: `{ "query": "ubuntu 22.04" }` (string, required, max 255 chars)
Output example:
```
Found 42 result(s) for "ubuntu 22.04":
1. Ubuntu 22.04.3 LTS Desktop amd64
Size: 1.47 GB | Health: 93.10% | Score: 92
Sqid: a1B2c3D4
URL: https://magnetz.eu/a1B2c3D4
Magnet Link: magnet:?xt=urn:btih:3B4C5D...
```

### Tool: get-magnet
Input: `{ "sqid": "a1B2c3D4" }` (string, required)
Output: Full torrent detail including files, trackers, and magnet link.

### Tool: get-magnet-by-infohash
Input: `{ "infohash": "3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C" }` (40-char hex, required)
Also accepts `urn:btih:` prefix.

### Client config, Claude Desktop
```json
{
  "mcpServers": {
    "magnetz": {
      "url": "https://magnetz.eu/mcp/magnetz"
    }
  }
}
```

### Client config, Claude Code
```bash
claude mcp add --transport http magnetz https://magnetz.eu/mcp/magnetz
```

## Use via REST API

Base URL: https://magnetz.eu
No authentication required. All endpoints return `application/json`.

### GET /api/magnets/search
Params: `query` (required), `page` (optional, default 1, max 4)

Example Request:
```
GET https://magnetz.eu/api/magnets/search?query=ubuntu+22.04&page=1
```

Example Response:
```json
{
  "data": [
    {
      "sqid": "a1B2c3D4",
      "name": "Ubuntu 22.04.3 LTS Desktop amd64",
      "info_hash": "3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C",
      "size": 1580945408,
      "human_size": "1.47 GB",
      "score": 0.92,
      "health": 0.85,
      "is_verified": true,
      "magnet_link": "magnet:?xt=urn:btih:3B4C5D...",
      "seeders": 421,
      "leechers": 18,
      "web_url": "https://magnetz.eu/a1B2c3D4"
    }
  ],
  "meta": { "total": 42, "per_page": 25, "current_page": 1 }
}
```

### GET /api/magnets/{sqid}
Returns full detail including files array, trackers array, release metadata.

### GET /api/magnets/infohash/{infohash}
Same response shape as `GET /api/magnets/{sqid}`.

## Useful Links

- [Browse](https://magnetz.eu/browse): Browse by type
- [Lists](https://magnetz.eu/lists): Public curated collections
- [RSS](https://magnetz.eu/rss): Recent torrents feed
- [OpenSearch](https://magnetz.eu/opensearch.xml): Browser search engine integration