Pinata MCP

Official
by PinataCloud

Integrations

  • Provides access to both Public and Private IPFS through Pinata's API, enabling file uploads, searches, metadata management, group organization, and content retrieval from IPFS gateways.

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!

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides Claude with access to Pinata's API, allowing it to interact with both Public and Private IPFS for file uploading, searching, organization, and content retrieval.

  1. Setup
    1. Prerequisites
    2. Installation
  2. Usage
    1. File Operations
    2. Group Operations
    3. Content Access
  3. Example Prompts for Claude
    1. Questions

      Related MCP Servers

      • A
        security
        F
        license
        A
        quality
        Integrates local Zotero libraries with Claude's Desktop interface, allowing users to access and manage their library collections via a local API.
        Last updated -
        6
        12
        Python
      • A
        security
        A
        license
        A
        quality
        This server provides tools for uploading images and videos directly to Cloudinary using Claude/Cline, facilitating resource management with customizable options like resource type and public ID.
        Last updated -
        1
        71
        4
        JavaScript
        MIT License
        • Apple
      • A
        security
        A
        license
        A
        quality
        This server facilitates interaction with Keboola's Storage API, enabling users to browse and manage project buckets, tables, and components efficiently through Claude Desktop.
        Last updated -
        7
        13
        Python
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        Provides tools for managing IP assets and licenses, interacting with the Story Python SDK, and handling operations like minting tokens, registering IP, and uploading metadata to IPFS.
        Last updated -
        11
        Python
        MIT License
        • Apple

      View all related MCP servers

      ID: ps4la8o8e8