Merge pull request 'pinchflat-mcp: add pagination, downloaded filter, and delete_media tool' (#5) from fix/pinchflat-mcp-pagination into main

Reviewed-on: #5

.gitignore

@@ -27,3 +27,4 @@ result-*
 # Local environment overrides
 .envrc.local
 /.dir-locals.el
+__pycache__/

packages/audiobookshelf-mcp/package.nix

@@ -12,10 +12,10 @@ buildGoModule rec {
     owner = "michaeldvinci";
     repo = "audiobookshelf-mcp";
     rev = "e790d9c75085772180c95f2ec1376acc98e9282c";
-    hash = lib.fakeHash;
+    hash = "sha256-vQR+Ej3Qtg8ehIUWnXkSayNYpqnOZPWV0TpTVPYh+io=";
   };
 
-  vendorHash = lib.fakeHash;
+  vendorHash = "sha256-W8hlCGf4QdFbKc3QFc9pa4MWBhnp5A5GvWFNzg0BEhw=";
 
   meta = with lib; {
     description = "MCP server for Audiobookshelf — libraries, audiobooks, podcasts, authors, collections, playlists";

packages/pinchflat-mcp/server.py

@@ -150,11 +150,25 @@ def force_metadata_refresh(source_id: int) -> dict:
 # --- Media Items ---
 
 @mcp.tool()
-def list_media(source_id: Optional[int] = None, limit: int = 50) -> dict:
+def list_media(
-    """List media items. Optionally filter by source_id."""
+    source_id: Optional[int] = None,
-    params = {}
+    limit: int = 50,
+    offset: int = 0,
+    downloaded: Optional[bool] = None,
+) -> dict:
+    """List media items with pagination. Optionally filter by source_id or download status.
+
+    Args:
+        source_id: Filter to a specific source
+        limit: Max items to return (default 50)
+        offset: Skip first N items for pagination (default 0)
+        downloaded: If True, only return downloaded media; if False, only undownloaded
+    """
+    params = {"limit": limit, "offset": offset}
     if source_id:
         params["source_id"] = source_id
+    if downloaded is not None:
+        params["downloaded"] = "true" if downloaded else "false"
     return _get("/media", params=params)
 
 
@@ -176,6 +190,23 @@ def force_download_media(media_id: int) -> dict:
     return _post(f"/media/{media_id}/force_download")
 
 
+@mcp.tool()
+def delete_media(media_id: int, prevent_download: bool = False) -> dict:
+    """Delete a media item's downloaded files from disk.
+
+    Args:
+        media_id: The media item ID to delete
+        prevent_download: If True, prevent the item from being re-downloaded in the future
+    """
+    params = {}
+    if prevent_download:
+        params["prevent_download"] = "true"
+    with httpx.Client(timeout=120) as client:
+        r = client.delete(f"{BASE}/media/{media_id}", headers=HEADERS, params=params)
+        r.raise_for_status()
+        return r.json()
+
+
 # --- Media Profiles ---
 
 @mcp.tool()