Pinata
About
Interact with Public and Private IPFS through Pinata's API. Requires a Pinata account and API key.
Details
- Author
- pinatacloud
- Categories
- File Management, API
Jump to
4 Configure Claude To Use The Local Build
Server Name: pinata-dev Server Scope: Project Server Command: node Command Arguments: /path/to/pinata-mcp/dist/index.js /path/to/allowed/directory Environment Variables: PINATA_JWT=<YOUR_JWT>,GATEWAY_URL=example.mypinata.cloud
Updateclaude_desktop_config.jsonto point to your local build:
{ "mcpServers": { "pinata-dev": { "command": "node", "args": [ "/path/to/pinata-mcp/dist/index.js", "/path/to/allowed/directory" ], "env": { "PINATA_JWT": "<YOUR_JWT>", "GATEWAY_URL": "example.mypinata.cloud" } } } }
- Rebuild:npm run build
- Restart Claude Code or Claude Desktop to pick up the changes
Use theMCP Inspectorto test the server:
npx @modelcontextprotocol/inspector \ -e PINATA_JWT=your_jwt \ -e GATEWAY_URL=your-gateway.mypinata.cloud \ -- node dist/index.js
This opens a browser UI where you can interactively list tools, call them with parameters, and inspect responses.
# List all available tools npx @modelcontextprotocol/inspector --cli --method tools/list \ -e PINATA_JWT=your_jwt \ -e GATEWAY_URL=your-gateway.mypinata.cloud \ -- node dist/index.js # Call a specific tool npx @modelcontextprotocol/inspector --cli --method tools/call \ --tool-name testAuthentication \ -e PINATA_JWT=your_jwt \ -e GATEWAY_URL=your-gateway.mypinata.cloud \ -- node dist/index.js
Test my Pinata connection: "Test my Pinata authentication to make sure everything is working" Upload an image to Pinata: "Upload this image 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" Fetch content from IPFS: "Fetch the content with CID QmX... from IPFS" Create a payment instruction for content monetization: "Create a payment instruction called 'Premium Content' that requires 0.01 USDC on Base to access" Pin an existing CID: "Pin the CID bafkreih5aznjvttude6c3wbvqeebb6rlx5wkbzyppv7garjiubll2ceym4 to my account" Vectorize files for AI search: "Vectorize the file with ID abc123 so I can search it semantically" Query vectorized content: "Search my vectorized files in group xyz for 'machine learning concepts'"
Interact with Cloudinary's media management platform using natural language.
A .NET MCP server for interacting with the Autodesk AEC Data Model API and Viewer.
Semantic search over IMAGIN.studio vehicle imagery API documentation, CDN configuration, and integration guides.
Access Microsoft services like Outlook, Calendar, and OneDrive via the Microsoft Graph API.
Allow your agent to connect to Pocketbase with ease.
Accesses optimized documentation from the TrueNAS middleware repository to understand its codebase and APIs.
Interact with the Unstructured API to manage data sources, destinations, workflows, and jobs.
Interact with the Intelligent Content Management platform through Box AI.
Persistent memory for AI agents. Store and retrieve files via 14 MCP tools with OAuth 2.0 auth. Free 10GB tier.
Quickly integrate with Tencent Cloud Storage (COS) and Data Processing (CI) capabilities powered
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.
- Node.js 18+ installed
- A Pinata account with an API key (JWT)
- A Pinata Gateway URL
Installation will depend on whether you are using Claude Code or Claude Desktop.
Runclaude mcp addand 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/directory Environment Variables: PINATA_JWT=<YOUR_JWT>,GATEWAY_URL=example.mypinata.cloud
Add the following config toclaude_desktop_config.json:
{ "mcpServers": { "pinata": { "command": "npx", "args": [ "pinata-mcp", "/path/to/allowed/directory", "/another/allowed/directory" ], "env": { "PINATA_JWT": "<YOUR_JWT>", "GATEWAY_URL": "example.mypinata.cloud" } } } }
Note:The directory arguments are optional. If not provided, the server will only allow access to the current working directory. You can specify multiple directories to allow file access from multiple locations.
Tools for content monetization using the x402 protocol:
Tools for cryptographic content verification using EIP-712 signatures:
To test the MCP server locally during development:
git clone https://github.com/PinataCloud/pinata-mcp.git cd pinata-mcp npm install
Create a.envfile in the project root (optional, you can also pass these in the MCP config):
PINATA_JWT=your_pinata_jwt_here GATEWAY_URL=your-gateway.mypinata.cloud
4. Configure Claude to use the local build
Server Name: pinata-dev Server Scope: Project Server Command: node Command Arguments: /path/to/pinata-mcp/dist/index.js /path/to/allowed/directory Environment Variables: PINATA_JWT=<YOUR_JWT>,GATEWAY_URL=example.mypinata.cloud
Updateclaude_desktop_config.jsonto point to your local build:
{ "mcpServers": { "pinata-dev": { "command": "node", "args": [ "/path/to/pinata-mcp/dist/index.js", "/path/to/allowed/directory" ], "env": { "PINATA_JWT": "<YOUR_JWT>", "GATEWAY_URL": "example.mypinata.cloud" } } } }
- Rebuild:npm run build
- Restart Claude Code or Claude Desktop to pick up the changes
Use theMCP Inspectorto test the server:
npx @modelcontextprotocol/inspector \ -e PINATA_JWT=your_jwt \ -e GATEWAY_URL=your-gateway.mypinata.cloud \ -- node dist/index.js
This opens a browser UI where you can interactively list tools, call them with parameters, and inspect responses.
# List all available tools npx @modelcontextprotocol/inspector --cli --method tools/list \ -e PINATA_JWT=your_jwt \ -e GATEWAY_URL=your-gateway.mypinata.cloud \ -- node dist/index.js # Call a specific tool npx @modelcontextprotocol/inspector --cli --method tools/call \ --tool-name testAuthentication \ -e PINATA_JWT=your_jwt \ -e GATEWAY_URL=your-gateway.mypinata.cloud \ -- node dist/index.js
Test my Pinata connection: "Test my Pinata authentication to make sure everything is working" Upload an image to Pinata: "Upload this image 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" Fetch content from IPFS: "Fetch the content with CID QmX... from IPFS" Create a payment instruction for content monetization: "Create a payment instruction called 'Premium Content' that requires 0.01 USDC on Base to access" Pin an existing CID: "Pin the CID bafkreih5aznjvttude6c3wbvqeebb6rlx5wkbzyppv7garjiubll2ceym4 to my account" Vectorize files for AI search: "Vectorize the file with ID abc123 so I can search it semantically" Query vectorized content: "Search my vectorized files in group xyz for 'machine learning concepts'"
Interact with Cloudinary's media management platform using natural language.
A .NET MCP server for interacting with the Autodesk AEC Data Model API and Viewer.
Semantic search over IMAGIN.studio vehicle imagery API documentation, CDN configuration, and integration guides.
Access Microsoft services like Outlook, Calendar, and OneDrive via the Microsoft Graph API.
Allow your agent to connect to Pocketbase with ease.
Accesses optimized documentation from the TrueNAS middleware repository to understand its codebase and APIs.
Interact with the Unstructured API to manage data sources, destinations, workflows, and jobs.
Interact with the Intelligent Content Management platform through Box AI.
Persistent memory for AI agents. Store and retrieve files via 14 MCP tools with OAuth 2.0 auth. Free 10GB tier.
Quickly integrate with Tencent Cloud Storage (COS) and Data Processing (CI) capabilities powered
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
