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

$3

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

$3

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=,GATEWAY_URL=example.mypinata.cloud
`

Claude Desktop

Add the following config to claude_desktop_config.json

`json
{
"mcpServers": {
"pinata": {
"command": "npx",
"args": [
"pinata-mcp",
"/path/to/allowed/directory"
],
"env": {
"PINATA_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:

$3

- 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

$3

- 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

$3

- 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!