Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PINATA_JWT | Yes | Your Pinata JWT API key | |
| GATEWAY_URL | No | Your Pinata gateway URL (e.g., example.mypinata.cloud) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| testAuthentication | Verify that your Pinata JWT is valid and working |
| searchFiles | Search for files in your Pinata account by name, CID, or MIME type. Returns a list of files matching the given criteria. |
| getFileById | Retrieve detailed information about a specific file stored on Pinata by its ID |
| updateFile | Update metadata for an existing file on Pinata including name and key-value pairs |
| deleteFile | Delete a file from your Pinata account by its ID |
| uploadFile | Upload a file to Pinata IPFS. Provide either a file:// URI or base64-encoded content. |
| createPrivateDownloadLink | Generate a temporary download link for accessing a private IPFS file from Pinata |
| createLink | Create a direct access link for a file stored on Pinata IPFS. For public files returns a gateway URL, for private files generates a temporary download link. |
| fetchFromGateway | Fetch content from Public or Private IPFS via Pinata gateway and return it |
| listGroups | List groups in your Pinata account with optional filtering by name |
| createGroup | Create a new group in your Pinata account to organize files |
| getGroup | Retrieve detailed information about a specific group by its ID |
| updateGroup | Update metadata for an existing group on Pinata |
| deleteGroup | Delete a group from your Pinata account by its ID |
| addFileToGroup | Add an existing file to a group in your Pinata account |
| removeFileFromGroup | Remove a file from a group in your Pinata account |
| createPaymentInstruction | Create a new x402 payment instruction for content monetization. Currently supports USDC (6 decimals) on Base/Base Sepolia only. |
| listPaymentInstructions | List and filter x402 payment instructions for content monetization |
| getPaymentInstruction | Retrieve a specific x402 payment instruction by ID |
| updatePaymentInstruction | Update an existing x402 payment instruction. Currently supports USDC (6 decimals) on Base/Base Sepolia only. |
| deletePaymentInstruction | Delete an x402 payment instruction |
| listPaymentInstructionCids | List CIDs associated with a payment instruction |
| addCidToPaymentInstruction | Associate a CID with a payment instruction for x402 monetization |
| removeCidFromPaymentInstruction | Remove a CID association from a payment instruction |
| addSignature | Add an EIP-712 cryptographic signature to a CID for content verification |
| getSignature | Get signature details for a specific CID |
| deleteSignature | Remove a signature from a CID |
| createSignedUploadUrl | Create a signed URL for client-side file uploads without exposing your API key |
| pinByCid | Pin an existing CID from the IPFS network to your Pinata account |
| queryPinRequests | Query the status of pin by CID requests |
| cancelPinRequest | Cancel a pending pin by CID request |
| vectorizeFile | Vectorize a file for AI/semantic search capabilities |
| deleteFileVectors | Delete vectors for a file |
| queryVectors | Query vectorized files in a group using semantic search |
| listAllowedDirectories | List all directories that this MCP server is allowed to access for file operations |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |