https://github.com/pinatacloud/pinata-mcp
https://github.com/pinatacloud/pinata-mcp
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pinatacloud/pinata-mcp
- Owner: PinataCloud
- License: mit
- Created: 2025-03-11T20:19:15.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-12T20:55:26.000Z (7 months ago)
- Last Synced: 2025-06-17T13:17:48.828Z (4 months ago)
- Language: JavaScript
- Size: 72.3 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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=,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:
### 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](mailto:steve@pinata.cloud) with any issues you may encounter!