Skip to content

MCP Server

Magnetz exposes a Model Context Protocol server so any MCP-compatible AI client can search torrent metadata and fetch magnet details directly — no copy-pasting, no manual API calls.

Server URLhttps://magnetz.eu/mcp/magnetz

Available Tools

TOOLsearch-magnets

Search torrents by name or keyword. Returns up to 25 results ordered by swarm health.

Input Schema

ParameterTypeRequiredDescription
querystringYesTorrent name or keywords, max 255 characters

Example Output

Found 120 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/magnet/a1B2c3D4
   Magnet Link: magnet:?xt=urn:btih:3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C
2. Ubuntu 22.04 Server amd64
   Size: 1.18 GB | Health: 88.50% | Score: 87
   Sqid: e5F6g7H8
   URL: https://magnetz.eu/magnet/e5F6g7H8
   Magnet Link: magnet:?xt=urn:btih:9A0B1C2D3E4F5A6B7C8D9E0F1A2B3C4D5E6F7A8B

Error Outputs

MessageCause
No results found for "..."Query succeeded but no matches
The query must contain at least one searchable character.Empty or whitespace-only query
Search backend is currently unavailable. Please try again later.Search engine temporarily unreachable
TOOLget-magnet

Retrieve full details for a single torrent by its Magnetz short ID (sqid), including all files, trackers, and magnet link.

Input Schema

ParameterTypeRequiredDescription
sqidstringYesShort alphanumeric ID from the magnet's page URL (e.g. a1B2c3D4)

Example Output

Name: Ubuntu 22.04.3 LTS Desktop amd64
Info Hash: 3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C
Size: 1.47 GB
Health: 93.10% | Score: 92
Files:
  - ubuntu-22.04.3-desktop-amd64.iso (1.47 GB)
Trackers:
  - udp://tracker.opentrackr.org:1337/announce
  - udp://open.tracker.cl:1337/announce
Magnet Link: magnet:?xt=urn:btih:3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C&dn=Ubuntu+22.04.3...

Error Outputs

MessageCause
Magnet not found for sqid: ...No active magnet with that ID
TOOLget-magnet-by-infohash

Look up a torrent by its SHA-1 info hash. Returns the same detail format as get-magnet.

Input Schema

ParameterTypeRequiredDescription
infohashstringYes40-character hex SHA-1 hash; optionally prefixed with urn:btih:

Example Inputs

3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C
urn:btih:3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C

Error Outputs

MessageCause
Invalid infohash format. Expected a 40-character hexadecimal hash.String is not valid hex or wrong length
Magnet not found for info hash: ...No active magnet with that hash

Client Configuration

This is an HTTP/SSE-based MCP server. Add the server URL to your client — no API key required.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). 

{
  "mcpServers": {
    "magnetz": {
      "url": "https://magnetz.eu/mcp/magnetz"
    }
  }
}

Restart Claude Desktop after saving. The tools will appear automatically in the tool picker.

Claude Code (CLI)

Add via the claude mcp add command or edit .claude/settings.json in your project.

Via CLI (recommended)

claude mcp add --transport http magnetz https://magnetz.eu/mcp/magnetz

Via .claude/settings.json

{
  "mcpServers": {
    "magnetz": {
      "type": "http",
      "url": "https://magnetz.eu/mcp/magnetz"
    }
  }
}

Example prompts in Claude Code

Search Magnetz for "arch linux 2024" and give me the top 3 results
Find the magnet for info hash 3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2C
Look up sqid a1B2c3D4 and show me all the files
Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json inside your project.

{
  "mcpServers": {
    "magnetz": {
      "url": "https://magnetz.eu/mcp/magnetz"
    }
  }
}

Example prompts in Cursor

@magnetz search for "debian 12 netinstall"
@magnetz get details for the torrent with sqid e5F6g7H8
I have this info hash: 3B4C5D6E... — look it up on Magnetz
VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace or to User Settings JSON under github.copilot.mcp.servers.

.vscode/mcp.json

{
  "servers": {
    "magnetz": {
      "type": "http",
      "url": "https://magnetz.eu/mcp/magnetz"
    }
  }
}

User settings.json

"github.copilot.mcp.servers": {
  "magnetz": {
    "type": "http",
    "url": "https://magnetz.eu/mcp/magnetz"
  }
}
Windsurf

Edit ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "magnetz": {
      "serverUrl": "https://magnetz.eu/mcp/magnetz"
    }
  }
}
Continue.dev

Add to ~/.continue/config.json under the experimental.modelContextProtocolServers array. 

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "http",
          "url": "https://magnetz.eu/mcp/magnetz"
        }
      }
    ]
  }
}
Zed

Add to your Zed settings (~/.config/zed/settings.json) under context_servers. 

{
  "context_servers": {
    "magnetz": {
      "settings": {
        "url": "https://magnetz.eu/mcp/magnetz"
      }
    }
  }
}

What to Ask Your AI

Once connected, you can use natural language — the AI will pick the right tool automatically.

PromptTool used
Search for "linux mint 21" and show me the top resultssearch-magnets
Find torrents matching "the office complete series"search-magnets
What files are in magnet a1B2c3D4?get-magnet
Get the magnet link for sqid a1B2c3D4get-magnet
Look up info hash 3B4C5D6E…get-magnet-by-infohash
Is there a torrent for urn:btih:3B4C5D…?get-magnet-by-infohash
Search for "ubuntu" and open the healthiest resultsearch-magnets → get-magnet

Troubleshooting

  • Tools not appearing: restart the client after adding the server URL; some clients require a reload.
  • No results: the query worked but had no matches — try broader keywords.
  • Invalid info hash: must be exactly 40 hex characters (0–9, A–F), optionally prefixed with urn:btih:.
  • Backend unavailable: the search engine is temporarily down — wait a moment and retry.
  • Connection refused: verify the server URL is reachable from your machine and matches the one shown above.