• STRUCTURE
  • DISCOVERY
  • CONTEXT
  • HUMAN

How to organize IPFS content groups with your AI

Connect Pinata Cloud to your AI client to manage decentralized storage. Once connected, your agent handles the heavy lifting of grouping and labeling your IPFS data.

Ask AI about this page

Short answer

How can I use my AI to organize IPFS content groups?

Your AI uses Pinata Cloud to create new pin groups, list existing ones, and update metadata for better organization. You get a structured storage setup without manual dashboard navigation.

The results.

Structured decentralized storage.

Your AI turns raw IPFS files into logical collections.

STRUCTURE

Logical file groupings

The AI creates specific pin groups to keep related files together. You move from a flat list of hashes to organized sets.

DISCOVERY

Instant group visibility

Your agent pulls a full list of your current pin groups. You can find exactly what you need without scrolling through a web UI.

CONTEXT

Descriptive metadata

The AI attaches labels and descriptions to your groups. This makes your decentralized data searchable and easy to identify.

HUMAN

Manual oversight

You decide which files belong in which groups. The AI follows your logic to group them, but you maintain final control over the structure.

The workflow

What your AI does when you request organization.

Your agent acts as the bridge between your natural language instructions and the Pinata Cloud API.

  1. Identify existing groups

    The AI checks your current Pinata setup to see what groups already exist. This prevents duplicate work and helps it understand your current structure.

    list_pin_groups

  2. Create new collections

    When you ask for a new category, the AI sets up a fresh pin group. This creates a dedicated container for your IPFS content.

    create_pin_group

  3. Apply descriptive labels

    The AI updates the metadata for your groups. It adds names or descriptions so you can identify the content later.

    update_pin_metadata

  4. Verify group status

    The AI re-checks the group list to confirm the new organization is active. It ensures the metadata changes were applied correctly.

    list_pin_groupsupdate_pin_metadata

Try it

Copy these to start.

Use these prompts to begin managing your IPFS content.

Starting points

Swap out the bracketed text with your actual group names or descriptions.

Pinata Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_7JBcuyseh1gEEVrXK75eYRJfl3EimeWehfC3ZAWK/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Pinata capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "pinata-cloud-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_7JBcuyseh1gEEVrXK75eYRJfl3EimeWehfC3ZAWK/mcp"
    }
  }
}
Copy into chat04

  • List all my current Pinata pin groups.

  • Create a new pin group called [Project Alpha] for my new assets.

  • Update the metadata for the [Project Alpha] group to include the description [Version 1.0].

  • Find the group named [Archive] and change its description to [Old Files].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Pinata Cloud once, then ask.

Just link your account via the Vinkius dashboard. Your credentials stay encrypted, and you can immediately start talking to your data in your preferred AI client.

Connect Pinata Cloud to your AI

FAQ

How the organization task behaves.

  • 01

    Can the AI delete my pin groups?

    No. The current tools only allow for creating, listing, and updating metadata. Deletion must be done manually.

  • 02

    Can the AI upload new files to IPFS?

    No. This specific set of tools focuses on managing and labeling existing pin groups, not the initial file upload process.

  • 03

    Will the AI change my actual file content?

    No. The AI only manages the metadata and the grouping structure. It cannot modify the data stored within the IPFS files themselves.

  • 04

    How does the AI know which group to update?

    The AI uses the list of existing groups to identify the correct target before applying any metadata updates.

  • 05

    Do I need to use the Pinata dashboard to see my changes?

    You don't have to. You can verify all changes and view your groups directly through your AI client.

  • More questions about Pinata Cloud? The Connector page answers them. See everything the Pinata Cloud Connector can do

Connect Pinata to Claude, Cursor, ChatGPT & more