pinata-mcp MCP Server

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.

Local serverstdio

What is the pinata-mcp Server?

pinata-mcp is an MCP project maintained in the pinatacloud/pinata-mcp repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Installation

The documented npm package is pinata-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares PINATA_JWT, GATEWAY_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
testAuthentication	Verify that your Pinata JWT is valid and working
uploadFile	Upload a file to Pinata (public or private IPFS)
searchFiles	Search files by name, CID, or MIME type
getFileById	Get detailed file information by ID
updateFile	Update file metadata (name, key-values)
deleteFile	Delete a file from Pinata
createLink	Create a gateway link for public or private files
createPrivateDownloadLink	Generate a temporary download link for private files
fetchFromGateway	Fetch content from IPFS via Pinata gateway
listGroups	List groups with optional filtering
createGroup	Create a new group for organizing files
getGroup	Get group details by ID
updateGroup	Update group information
deleteGroup	Delete a group
addFileToGroup	Add a file to a group
removeFileFromGroup	Remove a file from a group
createPaymentInstruction	Create payment requirements for gated content
listPaymentInstructions	List/filter existing payment instructions
getPaymentInstruction	Get details of a specific payment instruction
updatePaymentInstruction	Modify payment instruction settings
deletePaymentInstruction	Remove a payment instruction
listPaymentInstructionCids	List CIDs associated with a payment instruction
addCidToPaymentInstruction	Associate a CID with a payment instruction
removeCidFromPaymentInstruction	Remove a CID association
addSignature	Add a cryptographic signature to a CID
getSignature	Get signature details by CID
deleteSignature	Remove a signature
createSignedUploadUrl	Create a presigned URL for client-side uploads
pinByCid	Pin an existing CID from the IPFS network
queryPinRequests	Query the status of pin requests
cancelPinRequest	Cancel a pending pin request
vectorizeFile	Vectorize a file for semantic search
deleteFileVectors	Delete vectors for a file
queryVectors	Query vectorized files using semantic search
listAllowedDirectories	List directories the server can access for file operations

How to install the pinata-mcp Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
PINATA_JWT	Declared in the maintainer’s client configuration.	Check documentation
GATEWAY_URL	Declared in the maintainer’s client configuration.	Check documentation