# Family Photo Counter MCP. AI Agent Connect > Family Photo Counter lets your AI agent navigate and audit your digital photo albums. It can scan through nested folders to find specific collections, pull detailed album info, and calculate exactly how many photos are tucked away in your sub-albums. It's a simple way to get a clear view of your digital memories without manual counting. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_iWwtXQGFfgDrXRbA8pcWnyHmaECFCo3CND1Gj9y3/ai-agent-connect - **Tags:** photos, albums, family, counting, management ## Description You can use this MCP to give your AI client a clear view of your digital photo storage. Instead of clicking through endless folders to see what you have, you can just ask your agent to find what you need. It can look through your entire album hierarchy to find specific collections or give you a flat list of everything you've saved. If you need to know the scale of a specific collection, the MCP can calculate the total photo count across an album and all its nested sub-folders. You can also pull specific photo IDs from a single folder or grab the full details of any specific album. It turns your messy photo directories into a searchable, countable database that your AI can interact with directly. ## Tools ### get_album_details This tool retrieves specific information about a single album. It provides the metadata and context needed to understand that collection. ### list_albums This tool returns a flat list of every album available in your system. You can also include a search query to filter the results by name. ### find_photos_by_album This tool provides a list of photo IDs located directly within a single album. It does not include photos from sub-albums. ### count_album_photos This tool calculates the total number of photos within a specific album. It includes every photo found in any nested sub-albums. ## Prompt Examples **Prompt:** ``` How many total photos are in the 'Summer Vacation 2023' album and all its sub-folders? ``` **Response:** ``` There are a total of 142 photos in the 'Summer Vacation 2023' album and its sub-albums. ``` **Prompt:** ``` List all the albums I have available. ``` **Response:** ``` You have the following albums: 'Summer Vacation 2023', 'Birthday Party', and 'Family Trip'. ``` **Prompt:** ``` What are the details for the album with ID 'abc-123'? ``` **Response:** ``` Album 'abc-123' is named 'Christmas 2022'. It contains 15 photos and has 2 sub-albums. ``` ## Capabilities ### Recursive Counting Your agent uses this to find the total photo count across nested sub-folders. ### Album Discovery The AI uses this to scan your entire library for specific collection names. ### Metadata Retrieval Your agent pulls specific details about an album to understand its contents. ### Direct Photo Access The AI gets specific photo IDs from a single folder for targeted tasks. ## Use Cases ### Library Auditing Check the total size of a specific year's worth of photos by counting all sub-folders at once. ### Album Discovery Ask your agent to find a specific vacation album among hundreds of other folders. ### Content Verification Get a list of photo IDs from a specific album to verify what is actually inside. ### Metadata Checks Quickly pull the specific details of an album to see how many sub-albums it contains. ## Benefits - Eliminates manual counting of photos in nested folders. - Provides a searchable interface for your photo collections via your AI client. - Allows for instant auditing of album sizes and contents. - Reduces the time spent navigating deep folder structures. ## How It Works Connecting this MCP to your AI client gives your agent immediate access to your photo metadata. 1. Connect your preferred MCP-compatible client to Vinkius. 2. The MCP exposes photo management tools to your agent. 3. Ask your agent a question about your albums or photo counts. 4. The agent calls the necessary tool to scan your folders. 5. Your agent delivers the specific counts or lists you requested. ## Frequently Asked Questions **How does the photo counting work for sub-folders?** The count_album_photos tool is recursive. It counts every photo in the main album and everything inside its sub-albums. **Can I search for specific albums by name?** Yes. You can use the list_albums tool and provide a search query to filter for the specific name you want. **Does this MCP work with Claude or Cursor?** Yes. This MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf. **Will it show me photos in sub-folders when I list a single album?** No. The find_photos_by_album tool only lists the IDs for photos directly inside that specific album. **Do I need to host this myself?** No. Vinkius hosts and manages the MCP for you. You just connect your client and start using it. **How does the photo count work for nested albums?** By using the `count_album_photos` tool, the system calculates a recursive total that includes all photos in the target album and all its sub-albums. **Can I search for a specific album?** Yes, you can use the `list_albums` tool with a search query to filter and find specific albums by name. **Does this tool show photos in sub-albums when listing album contents?** No, the `find_photos_by_album` tool only returns photos directly inside the specified album, not those in nested sub-albums.