xrel-mcp

MCP server for the xREL API — browse scene & P2P releases, search, categories, and more.

Based on the semi-official OpenAPI specification.

Setup

Add to your MCP client config:

{
  "mcpServers": {
    "xrel": {
      "command": "npx",
      "args": ["-y", "xrel-mcp"]
    }
  }
}

Optional: API authentication

Set environment variables for Client Credentials authentication:

{
  "mcpServers": {
    "xrel": {
      "command": "npx",
      "args": ["-y", "xrel-mcp"],
      "env": {
        "XREL_CLIENT_ID": "your_client_id",
        "XREL_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Without credentials, all public endpoints work fine. Authentication gives you higher API trust.

Tools

Releases (Scene)

• release_info — Get info about a single release by ID or dirname
• release_latest — Browse latest releases, with optional archive/filter
• release_categories — List available release categories
• release_browse_category — Browse releases by category (e.g. TOPMOVIE, TOPGAME, TVSERIES)
• release_ext_info — Get all releases for a given Ext Info
• release_filters — List predefined public filters
• release_addproof — Add a proof picture to a release [OAuth]

Releases (P2P)

• p2p_releases — Browse P2P/non-scene releases
• p2p_categories — List P2P release categories
• p2p_release_info — Get info about a single P2P release

NFO

• nfo_release — Get NFO image for a scene release [OAuth]
• nfo_p2p_release — Get NFO image for a P2P release [OAuth]

Calendar

• calendar_upcoming — Upcoming movies and their releases (de or us)

Ext Info

• ext_info — Detailed info about a movie, TV show, game, etc.
• ext_info_media — Media (images, videos) for an Ext Info
• ext_info_rate — Rate an Ext Info 1-10 [OAuth]

Search

• search_releases — Search scene and P2P releases
• search_ext_info — Search Ext Infos by type

Comments

• comments_get — Get comments for a release
• comments_add — Add a comment with optional video/audio ratings [OAuth]

Favorites

• favs_lists — Get all favorite lists [OAuth]
• favs_list_entries — Get entries of a favorite list [OAuth]
• favs_list_addentry — Add an Ext Info to a favorite list [OAuth]
• favs_list_delentry — Remove an Ext Info from a favorite list [OAuth]
• favs_list_markread — Mark a release as read [OAuth]
• favs_ext_id — Check which lists contain an Ext Info [OAuth]

User

• user_info — Get authenticated user info [OAuth]

Configuration

| Environment Variable | Description | Default | |---|---|---| | XREL_CLIENT_ID | OAuth2 Client ID | — | | XREL_CLIENT_SECRET | OAuth2 Client Secret | — | | XREL_BASE_URL | API base URL | https://api.xrel.to/v2 |

License

MIT