# Pinata Cloud MCP for AI Agents AI Agent Connect

> Pinata Cloud MCP lets you manage decentralized storage and IPFS pinning through your AI client. You can upload files, organize them into groups, and track your storage usage without leaving your workspace. It handles the heavy lifting of Web3 content management so you can focus on building.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_7JBcuyseh1gEEVrXK75eYRJfl3EimeWehfC3ZAWK/ai-agent-connect
- **Tags:** ipfs, decentralized-storage, web3, file-pinning, nft-hosting, metadata-management

## Description

Managing decentralized storage usually means jumping between a web dashboard and your terminal, constantly copy-pasting CIDs and checking if your files are actually pinned. This Connector changes that by bringing Pinata Cloud directly into your chat interface. Instead of manual uploads, you just tell your AI agent to pin a JSON file or create a new collection. It handles the technical details of IPFS orchestration while keeping your metadata organized. You can check your current storage limits, rotate API keys, and clean up old pins using plain language. It's a huge time saver for anyone who deals with Web3 content daily. If you're tired of the friction of manual decentralized file management, this is how you make it feel like a native part of your development workflow. You'll find this is one of the most practical ways to use the Vinkius catalog to manage your Web3 infrastructure.

## Tools

### list_ipfs_pins
Lists every file currently pinned to the network. This helps you audit your active content.

### revoke_api_key
Disables a specific API key immediately. Use this to secure your account if a key is leaked.

### verify_pinata_auth
Checks if your connection is active. Use this to troubleshoot your setup quickly.

### list_pin_groups
Shows all your current pin collections. Use this to see how your storage is organized.

### list_api_keys
Shows your active account keys. Use this to keep track of which keys are in use.

### update_pin_metadata
Changes the name or tags of an existing pin. This keeps your asset catalog accurate.

### pin_json_to_ipfs
Uploads JSON metadata to the decentralized web. It's the go-to for pinning NFT assets.

### remove_ipfs_pin
Deletes a file or hash from your active pins. Use this to free up storage space.

### create_pin_group
Makes a new collection for your files. Use this to keep related assets together.

### remove_pin_group
Deletes an entire collection. Use this to clean up old project folders.

### get_pinning_stats
Shows your current data usage. Use this to stay under your storage plan limits.

### get_group_details
Pulls specific info about a storage group. Use this to verify group settings.

## Prompt Examples

**Prompt:** 
```
Show me my current storage usage and list all my pin groups.
```

**Response:** 
```
Here is your current storage status:

- **Total Usage**: 2.4 GB
- **Plan Limit**: 5.0 GB
- **Remaining**: 2.6 GB

Your active groups are:
*   `Summer_Collection_v1`*   `Metadata_Archive`*   `Profile_Assets`

Would you like me to check the details of any specific group?
```

**Prompt:** 
```
Pin this NFT metadata JSON to IPFS and give it a custom name.
```

**Response:** 
```
I've pinned that metadata for you.

- **CID**: `bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenrj`
- **Name**: "summer_collection_v2"
- **Status**: Pinned across 3 nodes for redundancy.

It's now live on the IPFS network. Do you want me to add it to a specific group?
```

**Prompt:** 
```
Which of my pins are taking up the most space?
```

**Response:** 
```
I've analyzed your pins. Here are the top 3 largest files:

| File Name | Size | CID |
| :--- | :--- | :--- |
| `nft-collection-images.zip` | 890 MB | `Qm...` |
| `video-assets-q2.mp4` | 456 MB | `Qm...` |
| `product-catalog.json` | 234 MB | `Qm...` |

Would you like me to unpin the oldest ones to save space?
```

## Capabilities

### Pin files and JSON to IPFS
Upload your assets and metadata to the decentralized web instantly.

### Create and manage storage groups
Organize your pinned content into logical collections and folders.

### Update metadata for pinned assets
Modify the names and tags of your existing pins via natural language.

### Monitor account storage limits
Check your current data usage to stay within your plan limits.

### Manage and rotate API keys
View active keys and revoke compromised ones to keep your account secure.

### Unpin old or unused content
Remove files from your active pins to free up storage space.

## Use Cases

### NFT Metadata Batching
A creator pins 500 JSON files for a new collection and asks the agent to group them by rarity using create_pin_group.

### Storage Audit
A developer asks the agent to list all pins and identify which ones haven't been accessed in months to clear space.

### Key Rotation
An engineer realizes a key was exposed and tells the agent to revoke it and list the remaining active keys.

### Dynamic Content Updates
A dev updates the name of a pinned asset group to reflect a new project phase using update_pin_metadata.

## Benefits

- Stop copy-pasting CIDs by having your agent retrieve them automatically after using pin_json_to_ipfs.
- Monitor your storage limits in real-time with get_pinning_stats to avoid unexpected overages.
- Keep your assets organized by creating and managing collections with create_pin_group and list_pin_groups.
- Improve security by quickly rotating keys using list_api_keys and revoke_api_key without leaving your editor.
- Maintain clean metadata by updating tags and names with update_pin_metadata instead of manual edits.
- Quickly purge old content with remove_ipfs_pin to stay within your storage plan.

## How It Works

The bottom line is you get a hands-free way to manage your decentralized storage assets.

1. Subscribe to the Pinata Cloud MCP in the Vinkius catalog.
2. Add your Pinata JWT from your account settings to your AI client.
3. Start asking your agent to pin files, list groups, or check your storage stats.

## Frequently Asked Questions

**How does Pinata Cloud MCP help with NFT projects?**
It lets you pin all your metadata files directly through your AI client, so you don't have to manually upload and track CIDs for every single asset.

**Can I use Pinata Cloud MCP to manage my API keys?**
Yes, you can list your active keys, check your connection status, and revoke any keys that are no longer needed, all using plain language.

**Will Pinata Cloud MCP help me stay under my storage limits?**
Definitely. You can ask your agent to check your current data usage at any time to see how much of your plan is left.

**Can I organize my decentralized files with Pinata Cloud MCP?**
You can create new groups for different projects and list your existing collections to keep your content organized.

**How do I connect Pinata Cloud MCP to my AI client?**
Just subscribe to the Connector on Vinkius and provide your Pinata JWT from your account settings.

**Can I delete files from IPFS using Pinata Cloud MCP?**
You can use the tool to unpin specific files or entire groups to free up your storage space.

**Can my AI automatically find the CID (hash) of a specific pinned file?**
Yes! Use the `list_pins` tool. Provide filters like the pin name, and your agent will respond with the unique IPFS hash (CID) and associated technical metadata in seconds.

**How do I find my Pinata JWT?**
Log in to Pinata, navigate to **API Keys**, click **New Key**, and ensure you select all **Admin** permissions. Copy the long **JWT** string provided at the end.