How to Use the Pics.io MCP in Claude Code

Q: How do I run a search on Pics.io using Claude Code?

Use the searchassets tool inside Claude Code to query your library. The terminal output can be piped directly to grep or jq for further filtering.

Q: Can I manage Pics.io collections from Claude Code?

Yes, you can run listcollections to view your folder hierarchy. Claude Code can then execute createcollection or deletecollection to manage your remote directories.

Q: How do I view asset comments in Claude Code?

Run listcomments to display all feedback associated with an asset ID. You can also append new feedback directly from your terminal using addcomment.

Q: Can I inspect file revisions from the command line?

Yes, listrevisions returns the full version history of any asset. This is useful for verifying deploy targets or checking audit trails.

Manage your Pics.io assets from your shell using Claude Code to automate metadata and collections.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Pics.io MCP to Claude Code

Create your Vinkius account to connect Pics.io to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Pics.io with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Query Assets Directly from the Terminal

`list_assets` outputs your media library data as clean JSON that you can pipe into other CLI utilities. Claude Code executes the query and lets you filter assets by collection IDs without leaving your shell. You can use `get_asset` to fetch detailed file metadata instantly. This allows you to inspect asset attributes, file paths, and tags directly from your terminal session.

Automate Directory Management via MCP Server

`create_collection` lets you build media directories right from your command line. Claude Code runs this command to set up staging folders for automated upload pipelines. If a deploy fails or a collection is no longer needed, Claude Code runs `delete_collection` to clean up the remote workspace. It keeps your remote media library in sync with your local directory structure.

Bulk Update Metadata and Tags

`update_asset` enables fast, programmatic metadata updates via this MCP integration. Claude Code can run a loop to apply tags, update descriptions, or change custom fields on hundreds of assets. To ensure audit compliance, Claude Code uses `list_revisions` to verify file changes. It lets you track who updated what and when, directly within your terminal logging tools.

Setup guide

Set up Pics.io MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see picsio-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Pics.io transactions." It will automatically discover and invoke the available Pics.io tools.

Terminal

claude mcp add --transport http picsio-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Pics.io MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "picsio-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pics.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Pics.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Pics.io MCP in Claude Code

Use the `search_assets` tool inside Claude Code to query your library. The terminal output can be piped directly to grep or jq for further filtering.

Yes, you can run `list_collections` to view your folder hierarchy. Claude Code can then execute `create_collection` or `delete_collection` to manage your remote directories.

Run `list_comments` to display all feedback associated with an asset ID. You can also append new feedback directly from your terminal using `add_comment`.

Yes, `list_revisions` returns the full version history of any asset. This is useful for verifying deploy targets or checking audit trails.

This MCP Server runs locally, meaning your API tokens, asset metadata, and folder paths never pass through external relays. Your authentication details stay encrypted in your local shell configuration.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript