// MCP TOOL REFERENCE

PINATA MCP TOOLS

35 tools from the Pinata MCP MCP Server, categorised by risk level.

// ALL 35 PINATA MCP TOOLS

READ 14 tools

Read fetchFromGateway Fetch content from Public or Private IPFS via Pinata gateway and return it Read getFileById Retrieve detailed information about a specific file stored on Pinata by its ID Read getGroup Retrieve detailed information about a specific group by its ID Read getPaymentInstruction Retrieve a specific x402 payment instruction by ID Read getSignature Get signature details for a specific CID Read listAllowedDirectories List all directories that this MCP server is allowed to access for file operations Read listGroups List groups in your Pinata account with optional filtering by name Read listPaymentInstructionCids List CIDs associated with a payment instruction Read listPaymentInstructions List and filter x402 payment instructions for content monetization Read queryPinRequests Query the status of pin by CID requests Read queryVectors Query vectorized files in a group using semantic search Read searchFiles Search for files in your Pinata account by name, CID, or MIME type. Returns a list of files matching the gi... Read testAuthentication Verify that your Pinata JWT is valid and working Read createPrivateDownloadLink Generate a temporary download link for accessing a private IPFS file from Pinata

WRITE 12 tools

Write removeCidFromPaymentInstruction Remove a CID association from a payment instruction Write removeFileFromGroup Remove a file from a group in your Pinata account Write vectorizeFile Vectorize a file for AI/semantic search capabilities Write addFileToGroup Add an existing file to a group in your Pinata account Write addSignature Add an EIP-712 cryptographic signature to a CID for content verification Write createGroup Create a new group in your Pinata account to organize files Write createLink Create a direct access link for a file stored on Pinata IPFS. For public files returns a gateway URL, for p... Write createSignedUploadUrl Create a signed URL for client-side file uploads without exposing your API key Write pinByCid Pin an existing CID from the IPFS network to your Pinata account Write updateFile Update metadata for an existing file on Pinata including name and key-value pairs Write updateGroup Update metadata for an existing group on Pinata Write uploadFile Upload a file to Pinata IPFS. Provide either a file:// URI or base64-encoded content.

DESTRUCTIVE 6 tools

Destructive cancelPinRequest Cancel a pending pin by CID request Destructive deleteFile Delete a file from your Pinata account by its ID Destructive deleteFileVectors Delete vectors for a file Destructive deleteGroup Delete a group from your Pinata account by its ID Destructive deletePaymentInstruction Delete an x402 payment instruction Destructive deleteSignature Remove a signature from a CID

FINANCIAL 3 tools

Financial createPaymentInstruction Create a new x402 payment instruction for content monetization. Currently supports USDC (6 decimals) on Bas... Financial addCidToPaymentInstruction Associate a CID with a payment instruction for x402 monetization Financial updatePaymentInstruction Update an existing x402 payment instruction. Currently supports USDC (6 decimals) on Base/Base Sepolia only.

// FAQ

How many tools does the Pinata MCP MCP server have? +

The Pinata MCP MCP server exposes 35 tools across 4 categories: Read, Write, Destructive, Financial.

How do I enforce policies on Pinata MCP tools? +

Route the Pinata MCP server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Pinata MCP tools fall into? +

Pinata MCP tools are categorised as Read (14), Write (12), Destructive (6), Financial (3). Each category has a recommended default policy.

Enforce policy on every Pinata MCP tool call.

Start from Pinata MCP, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.