Skip to main content

​
What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude to interact with external tools and services. MCP servers expose capabilities that AI models can use to perform actions on your behalf. The Pinata MCP server gives Claude (and other MCP-compatible assistants) the ability to:
  • Upload and manage files on IPFS (public and private)
  • Search, retrieve, and delete files
  • Organize files into groups
  • Create gateway links for sharing content
  • Set up content monetization with x402 payment instructions
  • Vectorize files for semantic search
  • Pin existing CIDs from the IPFS network

​
Prerequisites

​
Installation

The Pinata MCP server is available on npm and can be run via npx. Installation depends on which Claude client you’re using.

​
Claude Code

Run claude mcp add and follow the prompts:

​
Claude Desktop

Add the following to your claude_desktop_config.json:
The directory arguments are optional and control which local directories the MCP server can access for file uploads. If not provided, the server only allows access to the current working directory. You can specify multiple directories.

​
Configuration

​
Verifying the Connection

Once installed, ask Claude to test the connection:
Claude will use the testAuthentication tool to verify your JWT is valid.

​
Next Steps

See the Tools Reference for a complete list of available tools with parameters and example prompts.