Skip to main content
Pinata’s MPP Server enables account-free file uploads and downloads to IPFS using crypto payments. No API key or Pinata account required — just pay with USDC on Tempo and get your files stored on IPFS.

​
Overview

The MPP Server is a payment-gated IPFS gateway built on the Machine Payments Protocol (MPP). It uses the HTTP 402 challenge-response pattern:
  1. Client makes a request to upload or download a file
  2. Server responds with 402 Payment Required and a payment challenge
  3. Client pays USDC on the Tempo network
  4. Client retries the request with proof of payment
  5. Server verifies payment and fulfills the request
This is ideal for machine-to-machine workflows where agents, bots, or services need to store and retrieve files without managing API keys.

​
Endpoints

MethodEndpointDescription
POST/v1/pin/public?fileSize={bytes}Get a signed upload URL
GET/v1/pin/public/:cidDownload a file by CID

​
Upload

Send a POST request with the fileSize query parameter (in bytes). After payment, the server returns a signed Pinata upload URL that you can use to upload your file directly. Pricing: fileSize (GB) x $0.10 x 12 months, minimum $0.01 USDC
File SizeCost
1 KB$0.01 (minimum)
1 MB$0.01 (minimum)
1 GB$1.20
10 GB$12.00
The signed URL is valid for 120 seconds after generation.

​
Download

Send a GET request with the file’s CID. After payment, the server proxies the file from Pinata’s IPFS gateway with the correct Content-Type and Content-Disposition headers. Pricing: Flat $0.01 USDC per download

​
Network

PropertyValue
ChainTempo Mainnet
Chain ID4217
RPChttps://rpc.tempo.xyz
TokenUSDC (0x20C000000000000000000000b9537d11c60E8b50)

​
Production URL

The Pinata-hosted MPP Server is available at: 
https://mpp.pinata.cloud

​
Next Steps

Quick Start

Upload your first file with MPP

Self-Hosting

Deploy your own MPP Server