Supercharge your AI with Pinata Cloud. Manage IPFS Pins, Groups, and Metadata from Chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Pinata Cloud MCP Server handles IPFS pinning and decentralized storage management. Use your AI agent to pin files, manage metadata for NFTs/JSON objects, and organize assets into named groups without touching a dashboard.
It gives you granular control over where and how your web3 content lives on the decentralized network.
What your AI can do
Create pin group
Creates a new named collection or group for related pinned assets.
Remove pin group
Deletes an entire pin collection group, removing all associated metadata links.
Get pinning stats
Checks the total data usage against your plan limits for operational monitoring.
Pin any file or JSON object to the decentralized web and immediately get its unique CID.
Create, list, or delete organizational groups to categorize your pinned assets.
Modify the names and tags associated with existing pins using natural language instructions.
Retrieve current account data usage statistics, showing how much storage you've consumed.
Fetch a list of all currently pinned files and retrieve their associated details.
Manage your account credentials by listing, revoking, or checking the status of API keys.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
Pinata Cloud MCP Server: 12 Tools for Decentralized Storage
Use these twelve tools to automate pinning operations, organize assets into collections, and monitor your entire IPFS infrastructure directly through your AI client.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Pinata Cloud on VinkiusCreate Pin Group
Creates a new named collection or group for related pinned assets.
Remove Pin Group
Deletes an entire pin collection group, removing all associated metadata links.
Get Pinning Stats
Checks the total data usage against your plan limits for operational monitoring.
Get Group Details
Retrieves all information about an existing pin group, including its members and...
List Pin Groups
Generates an index of all existing pin groups or collections you've created.
List Api Keys
Displays all active API keys associated with your Pinata account for security review.
List Ipfs Pins
Fetches a complete list of every file and hash currently pinned to the network.
Pin Json To Ipfs
Pins a JSON metadata file directly to IPFS, making it permanently available on the...
Revoke Api Key
Immediately disables or deactivates a specific API key for security reasons.
Verify Pinata Auth
Runs a check to confirm that your connection credentials are valid and active.
Remove Ipfs Pin
Removes or unpins a specific file hash from your decentralized storage.
Update Pin Metadata
Modifies the display name, tags, or metadata associated with an existing pin hash.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token from
cloud.vinkius.com. For OAuth-protected servers, expand Advanced
settings to add credentials.
Start a conversation
Open a new chat. The Pinata Cloud integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Pinata Cloud, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pinata. 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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 12 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Managing decentralized assets shouldn't require juggling six different tabs.
Today, managing a web3 asset means opening the pinning dashboard to upload metadata. Then you switch to the key management console to check if your API keys are good. If you need to rename something or group it, you have to go back and forth between three different pages just to make one small change.
With this MCP server, your AI agent handles that entire sequence in a single chat thread. You tell it what needs to happen—'Pin this JSON, name it 'V2,' and put it in the 'Project X' group.' Done.
The Pinata Cloud MCP Server: Manage files & groups from your agent.
Forget manually running `list_ipfs_pins` to find a hash, and then opening another tool just to rename it. You use the chat interface to tell the server, 'Update the name for the pin with CID X.' It handles the lookup and modification in one step.
It’s not about *if* you can manage your data; it's about how efficiently. Your agent lets you execute complex pinning workflows—like creating a group, adding pins, then updating metadata—without ever leaving the chat window.
What your AI can actually do with this
You're running Web3 stuff. You don't wanna leave your chat window open just to manage IPFS pins or metadata. This server lets your AI agent handle all that decentralized storage work using natural language. It gives you granular control over where and how your web3 content lives on the decentralized network, letting you act like a full-time Web3 architect right from your prompt.
Getting Set Up and Checking Credentials
verify_pinata_auth: Run this tool to check if your connection credentials are valid; it confirms that your agent can talk to Pinata's system.list_api_keys: You can use this to see every active API key tied to your account, which is good for a security review. If you need to lock down an old credential,revoke_api_keyimmediately disables or deactivates a specific API key.
Pinning and Content Management
pin_json_to_ipfs: Pin this tool lets your agent take a JSON metadata file and pin it directly to IPFS, guaranteeing it's permanently available on the network.list_ipfs_pins: To see everything you’ve stored, this fetches a complete list of every single file hash currently pinned to the decentralized storage.update_pin_metadata: If the display name or tags on an existing pin need changing, this modifies that metadata associated with a specific pin hash using plain language instructions. You can also use your agent to remove old content;remove_ipfs_pinunpins and removes a specific file hash from your storage.
Organizing Your Assets into Groups
list_pin_groups: To get an index of everything you've organized, this generates a list of all existing pin groups or collections.create_pin_group: This tool lets you establish a new named collection or group for related pinned assets. When you need to know what’s inside a specific category,get_group_detailsretrieves all the information about an existing pin group, including its members and settings. If that whole group is obsolete,remove_pin_groupdeletes the entire pin collection group, pulling out all associated metadata links.
Monitoring Usage and Cleanup
get_pinning_stats: This checks your total data usage against your plan limits so you know exactly how much storage you've consumed.list_api_keys: You can also use this tool to view credentials, which is necessary for auditing.
Basically, your AI client handles the whole lifecycle of your web3 content: pinning assets using the IPFS network and getting back that unique CID (Content Identifier), keeping a high-fidelity catalog of all your decentralized data. It manages groups so you don't lose track of collections, updates metadata on the fly, tracks exactly how much storage you’re blowing through, and lets you audit and revoke keys without ever touching a dashboard.
019dd13b-ab61-714d-bafe-c916309a715e 
Here's how it actually works
The bottom line is: you talk to your AI client like talking to a storage manager, and it handles all the API complexity behind the scenes.
First, subscribe to the server and provide your Pinata JWT (JSON Web Token) from your API keys settings.
Second, prompt your AI client with a specific command—for instance, 'Pin this metadata file and name it v3.'
Third, the agent executes the necessary tool calls, returning confirmation of the CID and any relevant status updates.
Who is this actually for?
Web3 Developers, NFT Creators, and Data Architects. This server is for people who are tired of juggling multiple dashboards—the pinning dashboard, the metadata editor, the usage tracker. If your job involves managing assets on IPFS and you hate manual API calls, this is for you.
You use it to pin collection metadata files in bulk and track which pins are available without switching from your coding environment.
You manage decentralized storage organization, automating the process of creating groups or unpinning old assets based on project lifecycle status.
You check get_pinning_stats to monitor overall resource consumption and use tools like list_ipfs_pins to audit data integrity.
What Changes When You Connect
You get full visibility into your data footprint. By running get_pinning_stats, you see exactly how much storage you've used against your plan limit. No guessing games about resource overhead.
Metadata control is instant. Instead of navigating a separate dashboard to rename an asset, use update_pin_metadata via conversation to change the name or tags on any pinned file.
Organization becomes simple and scalable. You can create new groups with create_pin_group or check existing ones using list_pin_groups, keeping your decentralized assets properly categorized.
Security actions are contained. Need to stop a leaked key? Use revoke_api_key. Or, if content is deprecated, simply run remove_ipfs_pin to unpin the hash immediately.
Audit trails simplify cleanup. You can list all pins using list_ipfs_pins, which lets you identify and target old or unused assets that need pinning removal via remove_ipfs_pin.
See it in action
Pinning a new NFT collection.
A developer needs to deploy 50 metadata JSON files for an NFT drop. They run the agent and prompt it: 'Pin these 50 files and group them as 'Project X Collection.''. The server uses pin_json_to_ipfs repeatedly, then runs create_pin_group, giving immediate confirmation of all CIDs.
Cleaning up old assets.
An engineer needs to free up 2GB of storage used by deprecated project files. They prompt: 'List my pins and tell me which ones haven't been touched in 90 days.' The agent runs list_ipfs_pins, identifies the stale hashes, and then executes remove_ipfs_pin for each one.
Restructuring data governance.
A team decides to split their old 'Core Assets' group into two. They first run list_pin_groups, confirm the ID of the old group, and then use remove_pin_group followed by create_pin_group for the new structure.
Checking credentials before deployment.
A team member just updated their API key. Before committing code, they run verify_pinata_auth. The agent confirms the connection is live and active, preventing a full build failure later on.
The honest tradeoffs
Treating assets as simple files.
Manually tracking hundreds of CIDs in spreadsheets because the tools don't give enough detail. This is time-consuming and error-prone, especially when names change.
Use list_ipfs_pins to get a comprehensive list of all hashes. Then use update_pin_metadata to apply consistent naming conventions or tags across groups.
Forgetting key management.
Leaving old, unused API keys active because they 'might be needed later.' This is a massive security hole and increases the attack surface area.
Periodically run list_api_keys to see everything. If a key isn't used in months, use revoke_api_key immediately.
Pinning assets without grouping them.
Just pinning files one by one without organization, leading to 'CID soup' that is impossible to audit or reference correctly later on.
Always use create_pin_group first. Pin your related items, and then use the group name for all future references.
When It Fits, When It Doesn't
Use this server if you need programmatic control over IPFS assets—specifically, if you manage metadata JSONs or large collections of pins and can't afford to switch contexts. The core value is managing the lifecycle (create, update, delete) of your data records, not just pinning them initially.
Don't use this if all you need is a simple file upload service that doesn't require metadata management or group organization; those are simpler services. You also don't need it if you only ever pin content once and never touch the key or name again. If your workflow requires checking usage limits (get_pinning_stats) or maintaining an organized, auditable collection structure, this tool is right for you.
Questions you might have
How do I check if my API keys are secure using list_api_keys? +
Run list_api_keys to see every key currently active. If you spot an unused or compromised key, use revoke_api_key immediately to disable it.
What is the difference between creating a pin group and pinning files? +
Pinning files (pin_json_to_ipfs) actually stores the data. Creating a pin group (create_pin_group) just creates an organizational container or index for those pins.
Can I list all my pinned files using list_ipfs_pins? +
Yes, running list_ipfs_pins provides a comprehensive report of every file hash currently on the network. It's your primary tool for auditing content.
How do I change the name of an existing pin? Use update_pin_metadata. +
You use update_pin_metadata and provide the specific hash (CID) you want to change, along with the new desired name or tag.
How do I check if my connection token is valid using `verify_pinata_auth`? +
It immediately confirms your API credentials and network access. If the tool returns a success status, you're good to go; otherwise, re-check your JWT for typos or expiration.
What is the process for removing an old file using `remove_ipfs_pin`? +
Running this tool unpins the specified CID or hash from IPFS. This action removes Pinata's active pinning commitment, stopping storage fees for that asset.
How can I track my current usage limits with `get_pinning_stats`? +
The tool gives a detailed breakdown of your total storage consumption against your plan limit. You'll see exactly how much data you've pinned and which categories are using the most space.
How do I set up a new organized folder with `create_pin_group`? +
You call the tool and provide a unique name for your collection. This establishes a container in Pinata, letting you logically group related assets without manual management.
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.
We've already built the connector for Pinata Cloud. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.