Pinata for AI agents

Pinata manages public IPFS files and groups, letting developers upload, inspect, and generate signed upload URLs. Web3 teams use it to pin and serve decentralized content reliably. Connect it once through Arc0, and your agent, or Claude, ChatGPT and Cursor, can use it through one MCP endpoint, limited to what each user approved.

Files and storageAPI keyMCP + RESTpinata.cloud
AUDIT LOG · PINATAPOLICY: acme-support
09:41:07 · claude · u_8f2read
pinata.list_gateways
List Gateways✓ allowed · 212ms
09:41:08 · claude · u_8f2read
pinata.get_public_group
Get Public Group✓ allowed · 164ms
09:41:09 · claude · u_8f2write
pinata.create_public_group
Create Public Group✓ approved · approved by user
09:41:12 · claude · u_8f2destructive
pinata.delete_public_group
Delete Public Group✕ blocked · policy: deny
EVERY PINATA CALL, ON THE RECORD
01 · USE CASES

What agents do in Pinata.

01

Upload a file to IPFS

Pin a file to IPFS so it is available through a public gateway.

02

Check a file's gateway status read-only

Look up how a pinned file resolves through the gateway before sharing its link.

03

Create a signed upload URL

Generate a constrained upload URL so a user can add a file without full API access.

02 · ACTIONS

9 Pinata actions, graded by risk.

Every Pinata action is tagged read, write or destructive, so one policy covers the whole app and new actions inherit the right default.

read

5

Look things up. Allowed by default.

  • pinata.list_gateways
    List Gateways
  • pinata.get_public_group
    Get Public Group
  • pinata.list_public_files
    List Public Files
  • pinata.list_public_groups
    List Public Groups
  • pinata.list_upload_metadata
    List Upload Metadata

write

3

Create and change things. Allow, or ask the user first.

  • pinata.create_public_group
    Create Public Group
  • pinata.update_public_group
    Update Public Group
  • pinata.create_signed_public_upload_url
    Create Signed Public Upload URL

destructive

1

Delete, cancel or archive. Ask first, or deny outright.

  • pinata.delete_public_group
    Delete Public Group
03 · HOW IT WORKS

Pinata in three steps.

  1. 01Your users connect PinataThey add their Pinata api key on Arc0 Connect, under your brand. It goes straight into the vault.
  2. 02You set the rulesReads run, writes like “create Public Group” can wait for the user, and “delete Public Group” can be denied outright.
  3. 03Any agent can actYour agent calls Pinata through the Arc0 SDK or MCP, and so can Claude, ChatGPT and Cursor. Every call lands on the audit log.
POLICY.TS
await arc0.policies.set('pinata', {
  read: 'allow',
  write: 'ask',        // create_public_group
  destructive: 'deny',  // delete_public_group
})

# Claude Code: the same connection, one URL
$ claude mcp add --transport http arc0 \
    https://mcp.arc0.ai/u/u_8f2
04 · AUTH AND DATA

How Pinata connects.

Users add their Pinata api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

The same Pinata connection serves your agent over MCP and your own backend over REST and the proxy, so a user connects once. How Arc0 handles credentials →

AUTH
API key
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · WORKS WITH

Use Pinata from any agent.

Claude
ChatGPT
Cursor
Codex
VS Code
OpenAI Agents SDK
Claude Agent SDK
Vercel AI SDK
Mastra
LangGraph
07 · FAQ

Pinata and Arc0, answered.

Q01

Can I use Pinata with Claude, ChatGPT or Cursor?

Yes. Connect Pinata to Arc0 once, then add your Arc0 MCP URL to Claude, ChatGPT, Cursor, Claude Code or any other remote-MCP client. Each assistant only gets the Pinata actions you allow.

Q02

How do users connect Pinata?

Users add their Pinata api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

Q03

Which Pinata actions can my agent take?

9 in total: 5 read, 3 write and 1 destructive, such as “create Public Group”. Your policies decide which of them each agent may call.

Q04

Can I stop my agent from deleting things in Pinata?

Yes. Actions like “delete Public Group” are graded destructive. Set destructive actions to deny, or to ask so the user approves each one, and blocked calls still show up on the audit log.

Q05

Can my own backend call Pinata too?

Yes. The same Pinata connection is available over REST and through the Arc0 proxy, so your product and your agent share one connection per user.

Get started

Plug Pinata into your agent.

Your users connect Pinata once, under your brand. Your agent gets 9 actions behind your policies, with every call on the record.

Free to build · MCP + REST · Audit log on every plan