Integration

Pinata integration

Pinata is an IPFS pinning service that provides easy-to-use APIs for uploading, pinning, and managing files on IPFS (InterPlanetary File System). Store and retrieve content-addressed data with dedicated gateways, manage pins, create groups for organization, and leverage IPFS for decentralized storage. Perfect for NFT metadata, dApps, Web3 applications, and decentralized content distribution.

Connect Pinata How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Pinata.Built from the 16 Pinata tools below, on the connection you add once.

Common Pinata use cases

adding searchable tags
managing storage costs
managing storage inventory
content lifecycle management
verifying api setup
team access management
uploading NFT metadata
auditing pinned content
auditing uploaded files
removing outdated files

What you can do with Pinata

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

File, 5 operations

delete_file_v3Delete file v3DELETEDeletes a Pinata v3 file by UUID. Pinata stops hosting the content; it may persist on IPFS through other nodes.
get_file_v3Get file v3GETRetrieves metadata for a specific Pinata file by its UUID via the v3 API.
list_files_v3List files v3GETLists files in your Pinata v3 account with filtering by name, CID, group, MIME type, and cursor-based pagination.
update_file_v3Update file v3PUTUpdates name and keyvalues metadata for a Pinata v3 file without re-uploading content. CID remains unchanged.
upload_fileUpload filePOSTUploads a file to IPFS via Pinata and pins it for permanent storage. Returns the CID (Content Identifier) for accessing the file on IPFS.

Pin, 3 operations

list_pinsList pinsGETLists all pinned files and data on your Pinata account. Supports filtering by status, metadata, date range, and pagination.
pin_by_cidPin by cidPOSTPins existing IPFS content to your Pinata account by specifying its CID. Ensures content persistence without re-uploading.
unpinUnpinDELETERemoves a pin from your Pinata account. The content will no longer be stored by Pinata but may remain available on IPFS through other pinning services.

Group, 2 operations

create_groupCreate groupPOSTCreates a new file group in Pinata v3 for organizing files. Returns the group UUID to use when uploading files.
list_groupsList groupsGETLists all file groups in your Pinata v3 account. Supports filtering by name or visibility and cursor-based pagination.

Api key, 1 operation

create_api_keyCreate api keyPOSTCreates a new Pinata API key with custom permissions. Control access to specific endpoints for security and team management.

Authentication, 1 operation

test_authenticationTest authenticationGETTests if your Pinata API key is valid and properly configured. Returns confirmation message on success.

Json, 1 operation

upload_jsonUpload jsonPOSTUploads JSON data directly to IPFS via Pinata. Perfect for NFT metadata, configuration files, and any structured data that needs decentralized storage.

Metadata, 1 operation

update_metadataUpdate metadataPUTUpdates metadata for an existing pinned file including name and custom key-value pairs. Does not modify the actual content.

Pin job, 1 operation

get_pin_jobsGet pin jobsGETLists pin-by-hash job statuses. Monitor asynchronous pinning operations for content being retrieved from the IPFS network.

Usage, 1 operation

get_data_usageGet data usageGETRetrieves storage usage statistics for your Pinata account. Returns total number of pins and storage space consumed.

Use Pinata from Claude Code, Cursor or Codex

Connect Pinata in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Pinata operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Pinata

Create your workspace
Sign up free. Nothing to install.
Connect Pinata once
Add your Pinata connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Pinata integration FAQ

What can you do with the Pinata integration?

LiveContext exposes 16 operations on Pinata, covering file, pin, group and api key. Common uses include adding searchable tags, managing storage costs and managing storage inventory.