# Pics.io MCP > Pics.io MCP Server connects your AI client directly to a professional Digital Asset Management (DAM) system. It lets you manage large media libraries—photos, videos, graphics—using natural conversation. You can search for specific assets by tag, create new themed collections, track version history (`list_revisions`), and even update metadata without touching the UI. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** digital-asset-management, media-library, metadata-management, version-control, file-organization ## Description **Pics.io MCP Server connects your AI client straight into a professional Digital Asset Management system. You can manage massive libraries of photos, videos, and graphics using nothing but natural conversation.** It's time you ditched the clunky UI and app-switching headache. Your agent handles all the heavy lifting—you just talk to it. Here’s what you can do. **Searching and Finding Assets** You wanna track down something specific? You don't have to scroll through thousands of files. Use `search_assets` to scan your entire media library using keywords or tags, instantly pulling up relevant assets. Need to check the full details on one file? Just give it an ID; `get_asset` pulls all that metadata for you. If you want a quick overview of what's in a particular group, `list_assets` shows you everything inside a specific collection by its ID. **Building and Organizing Collections** You can build out your organizational structure right through chat. Use `create_collection` to set up a brand new, named grouping for assets. If you need to see what collections already exist or view the details of an existing group, run `list_collections` or use `get_collection`. And listen, if that whole collection is junk and you ain't using it, you can permanently wipe it out with `delete_collection`. **Updating Info and Descriptions** Don't sweat the manual tagging. You can improve searchability by running `update_asset`, which changes key metadata—like titles or descriptions—for a file without actually touching the original media itself. If you just need to know what assets are in your library, `list_assets` gives it to ya. To get all the raw details for any single asset ID, `get_asset` is your play button. **Auditing History and Feedback** Ever wonder who touched that file last or why? You can check the full version history using `list_revisions`, which shows you when changes happened. If someone left feedback on an image, use `list_comments` to pull up every single comment attached to that asset. To attach your own notes or give feedback to a teammate, run `add_comment` and pin your thoughts right onto the media file. **The Bottom Line** You get full control over massive assets using just prompts. You can look up an item's metadata (`get_asset`), list everything in a group (`list_assets`), build new groups (`create_collection`), track every version change (`list_revisions`), and even nail down specific feedback notes on one file (`list_comments`)—all without ever leaving your chat window. It’s pure power, baby. ## Tools ### add_comment Attaches a specific comment and feedback note to an existing media asset. ### create_collection Builds a new, named grouping of assets within your library structure. ### delete_collection Permanently removes an entire collection from the Pics.io system. ### get_asset Retrieves all metadata and details for one specified asset ID. ### get_collection Fetches full details about a specific, existing asset collection. ### list_assets Lists assets in your library, with the option to filter by a specific collection ID. ### list_collections Shows a complete list of all collections you have created or are currently using. ### list_comments Displays every comment and piece of feedback left on one asset. ### list_revisions Retrieves the full history of versions for an asset, showing when changes occurred. ### search_assets Searches your entire media library using keywords or tags to find relevant assets. ### update_asset Changes metadata—like the title or description—for an asset without changing the file itself. ## Prompt Examples **Prompt:** ``` Search for all assets tagged with 'Summer 2024'. ``` **Response:** ``` I've retrieved your assets. You have 12 files matching 'Summer 2024', including 8 high-res photos and 4 videos. Would you like to see the details for any of them? ``` **Prompt:** ``` Search for all brand photography assets tagged with summer campaign 2025. ``` **Response:** ``` Found 34 assets matching "summer campaign 2025". 18 are high-resolution photos (4K+), 8 are social media graphics (1080x1080), 5 are banner images (1920x600), and 3 are video thumbnails. Top collection: "Beach Lifestyle" with 12 assets. All assets have approved brand guidelines tags. 6 were uploaded in the last 7 days by the creative team. ``` **Prompt:** ``` Create a new collection called Q3 Marketing Materials and move the approved assets into it. ``` **Response:** ``` Collection "Q3 Marketing Materials" created successfully (ID: col_8234). 27 approved assets have been organized into the collection: 14 product photos, 8 social templates, 3 presentation decks, and 2 brand guideline documents. The collection has been shared with the marketing team (view access) and the design team (edit access). A shareable link has been generated for external agency collaboration. ``` ## Capabilities ### Search and Locate Assets Use the AI agent to search for assets across your entire library based on tags, keywords, or criteria. ### Build and Manage Collections Programmatically create new asset collections and view details about existing groups of media files. ### Manage Metadata and Descriptions Update key asset information, like titles or custom fields, using natural language prompts to improve searchability. ### Audit Asset History and Feedback Track the version history (`list_revisions`) of a file or pull all comments left on it via `list_comments`. ### View Specific Assets Get detailed metadata for any single asset or collection using the ID. ## Use Cases ### The Campaign Review: A Marketing Manager needs all approved images for a Q3 campaign. Instead of clicking through folders, they prompt their agent: 'Search for assets tagged Q3 and status Approved.' The agent runs `search_assets`, immediately listing 42 files ready to go. ### The Version Control Issue: A Designer realizes the client used an outdated version of a logo. They ask their agent: 'What are all revisions for Logo-V1?' The agent runs `list_revisions`, showing timestamps and identifying the correct, most recent file ID. ### Organizing New Content: A team just shot 50 photos. A Creative Director asks their agent to 'Create a collection called Beach Lifestyle and add all files tagged summer.' The agent uses `create_collection` and adds the assets, instantly grouping them for the next campaign. ### Finding Specific Info: An Operations Manager needs to know if a specific asset has been commented on. They send: 'List comments for Asset ID 990.' The agent runs `list_comments` and provides the full feedback history immediately. ## Benefits - Never manually tag files again. Use `search_assets` to find assets instantly by keywords or tags across the whole library. - Maintain campaign organization using `create_collection`. You can group related photos and graphics into a single collection, making sharing simple. - Keep an accurate audit trail of feedback. Call `list_comments` on any asset so you know who said what about it, right in your chat window. - Track file changes with certainty. The `list_revisions` tool shows the full version history for a file, so nobody can accidentally use old art. - Fix messy metadata fast. Use `update_asset` to change titles or descriptions across hundreds of files without opening the DAM interface. ## How It Works The bottom line is your AI client becomes a dedicated digital librarian for your entire media library. 1. Subscribe to this server and enter your Pics.io Personal Access Token in the integration settings. 2. Send a prompt to your AI client (Claude, Cursor, etc.) telling it what asset action you need—for example, 'Find all assets tagged summer 2024.' 3. The agent executes the necessary tool calls (like `search_assets`) and presents the results or confirmation directly in the chat. ## Frequently Asked Questions **How do I use `search_assets` with specific tags?** Just mention the tag in your prompt. For example: 'Search for assets tagged summer 2024 and high-resolution.' The agent runs `search_assets` and filters results based on those criteria. **Can I see if an asset was changed after it was approved using `list_revisions`?** Yes. Running `list_revisions` gives you the complete change log for a file, showing who made what edit and when. This is critical for version control. **What's the difference between `get_asset` and `search_assets`?** `get_asset` requires you to know the exact asset ID and retrieves all data for that single file. `search_assets`, however, finds files across your library based on criteria like keywords or tags. **Do I need to use `list_collections` before creating one?** No. You can run `create_collection` anytime. Running `list_collections` just shows you what groupings already exist so you don't accidentally name a new collection the same as an old one. **If I use `update_asset` to change metadata, what format should the custom fields be in?** You must supply a structured JSON object containing all field changes. The tool expects specific key-value pairs for titles, descriptions, and any custom attributes you want to modify. **Are there rate limits when calling `list_assets` or other listing tools?** Yes, the Vinkius platform enforces standard API usage rates. If your calls exceed these limits, the tool will fail with a 429 error code. Wait a few minutes before retrying. **When I run `delete_collection`, is there any way to recover the assets?** No, deletion via this tool is irreversible and cannot be undone through the server. You must double-check the Collection ID before executing the command, as it removes the collection structure entirely. **What happens if I try to use `add_comment` on an asset that doesn't exist?** The tool will immediately return a 404 error. You must provide the correct, existing Asset ID in your prompt or script for the operation to succeed. **Can my AI automatically find the latest comments for a specific asset by its ID?** Yes! Use the `list_comments` tool with the Asset ID. Your agent will respond with complete metadata for the conversation thread, including timestamps and author details in seconds. **How do I find my Pics.io Personal Access Token?** Log in to Pics.io, navigate to **Account Settings** > **Integrations**, and look for the 'Personal Access Token' section to generate your unique secret key. **Can I search for assets across all collections?** Absolutely. Use the `search_assets` tool with your query. The agent will return all matching files from your entire DAM, regardless of which collection they reside in.