What is Pinata Mcp

pinata-mcp is a Model Context Protocol (MCP) server that enables Claude to access Pinata, allowing interaction with both Public and Private IPFS through Pinata’s API.

Use cases

Use cases for pinata-mcp include uploading images or documents to Pinata, organizing files into groups for easier management, creating private links for secure file sharing, and accessing content from the IPFS network.

How to use

To use pinata-mcp, install it via Claude Code or Claude Desktop. For Claude Code, run ‘claude mcp add’ and provide the necessary information. For Claude Desktop, add the configuration to ‘claude_desktop_config.json’. Start using it by launching Claude Code or Claude Desktop and executing file operations.

Key features

Key features of pinata-mcp include file operations such as uploading, searching, updating metadata, and deleting files. It also supports group operations for organizing files and content access features like creating private download links and fetching content from the IPFS gateway.

Where to use

pinata-mcp can be used in various fields that require decentralized storage solutions, such as digital asset management, content distribution, and applications that leverage blockchain technology.

pinata-mcp

A Model Context Protocol (MCP) server that provides Claude with access to Pinata. This integration allows Claude to interact with Public and Private IPFS through Pinata’s API.

Setup

Prerequisites

• Node.js 18+ installed
• A Pinata account with an API key (JWT)

Installation

Installation will depend on whether you are using Claude Code or Claude Desktop

Claude Code

Run claude mcp add and follow the prompts with the following information:

Server Name: pinata
Server Scope: Project or Global
Server Command: npx
Command Arguments: pinata-mcp /path/to/allowed/directories /another/path/to/allowed/directories
Environment Variables: PINATA_JWT=<YOUR_JWT>,GATEWAY_URL=example.mypinata.cloud

Claude Desktop

Add the following config to claude_desktop_config.json

{
  "mcpServers": {
    "pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/path/to/allowed/directory"
      ],
      "env": {
        "PINATA_JWT": "<YOUR_JWT>",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

Usage

To start using the MCP start up Claude Code with the command claude or start Claude Desktop. Below are the available operations:

File Operations

• Upload files to Pinata (public or private IPFS)
• Search files by name, CID, or mime type
• Get file details by ID
• Update file metadata including name and key-values
• Delete files from Pinata

Group Operations

• List groups with optional filtering
• Create groups for organizing files
• Get group details by ID
• Update group information
• Delete groups
• Add/remove files to/from groups

Content Access

• Create private download links for accessing private files
• Fetch content from IPFS gateway and optionally save locally

Example Prompts for Claude

Here are some examples of how to instruct Claude to use pinata-mcp:

Upload an image to Pinata:
"Please upload the file at ~/Pictures/example.jpg to my Pinata account as a private file named 'My Example Image'"

Search for files:
"Search my Pinata account for all PNG files"

Create a group and add files:
"Create a new group called 'Project Assets' on Pinata, then find all my JSON files and add them to this group"

Download content from IPFS:
"Fetch the content with CID QmX... from IPFS and save it to my Downloads folder"

Questions

Send us an email with any issues you may encounter!