en How to Integrate Pinata Using MCP
Manage IPFS-pinned files on Pinata. This guide creates an MCP server from Arthur's Pinata template — tools preconfigured against https://api.pinata.cloud/v3 — and finishes by sharing the server's MCP swagger documentation.
-
Open the Secrets vault and create a secret named
PINATA_API_KEYholding your access token. Generate a Pinata API JWT (with appropriate org:files scopes) from the Pinata dashboard and send it as Authorization: Bearer <YOUR_PINATA_JWT>.Open the Secrets vault to store the Pinata credential before using the template.
Start the New secret wizard.
Name the secret PINATA_API_KEY — servers reference it by this name.
-
Go to the REST API Templates gallery and search for Pinata.
Record what the credential is for so it stays recognizable.
Continue to the protected value step.
-
Click Use template on the Pinata card to open the server-creation dialog.
Enter the credential value — a demo value here; use your real key when adopting the integration.
Review the generated secret reference syntax.
-
Review the server name and select
PINATA_API_KEYin the credential field — the dialog only accepts vault secrets, and it lists every tool that will be created.Store the PINATA_API_KEY secret in the vault.
Open the REST API template gallery.
Search the gallery for the Pinata integration.
-
Click Create server. Arthur creates the server, applies the authentication, and generates all the tools.
Open the Pinata template with its preconfigured tools.
Name the server after the integration it provides.
Pick the PINATA_API_KEY secret from the vault suggestions.
Select the stored credential.
Create the Pinata server with its preconfigured tools.
-
Open the server's Tools tab to review the generated tools.
Review the tools generated from the Pinata template.
-
Open the server's Connect section and click Share the MCP swagger documentation — Arthur generates the public documentation link and QR code for this server.
Open the server's Connect section, where the MCP endpoint and its documentation live.
Open the MCP swagger documentation share panel.
Show the generated swagger documentation link and QR code for this server.
The server appears with 4 preconfigured tool(s): list_files, get_file, delete_file, pin_by_cid. The Connect section offers the MCP swagger documentation — a shareable page with setup instructions for any AI client.
- List, retrieve, delete, and pin existing IPFS content by CID on Pinata's public or private IPFS network.
- This integration requires a credential (bearer). Get one at https://app.pinata.cloud/register.
- Official API documentation: https://docs.pinata.cloud/
- Editing a tool later never changes the template — templates are starting points, and the server is fully yours after creation.