• PERSISTENCE
  • INVENTORY
  • CLEANUP
  • HUMAN

How to automate IPFS pinning with your AI

Connect Filebase to your AI client to handle decentralized storage tasks. Once connected, your agent manages your IPFS data directly.

Ask AI about this page

Short answer

How can I automate IPFS pinning with my AI?

You can use your AI to add new content to IPFS, list existing pins, or remove old ones using Filebase. This lets you manage persistent decentralized storage through natural language commands. You'll get full control over your pinning set without touching a CLI.

Storage outcomes

What your AI manages

The results of letting your agent handle Filebase operations.

PERSISTENCE

Keep data online

Your AI uses Filebase to pin content to the IPFS network. This ensures your files stay accessible and don't disappear from the network.

INVENTORY

Track your pins

The agent can pull a full list of everything you have currently pinned. You'll see exactly what's taking up space in your storage.

CLEANUP

Remove old data

When files are no longer needed, your AI can unpin them. This keeps your storage organized and prevents unnecessary costs.

HUMAN

Manual review

You decide which files are important enough to keep. The AI handles the technical execution, but you maintain final authority over your data.

The workflow

What your AI does when a storage request arrives.

The AI translates your intent into specific Filebase operations.

  1. Pinning content

    When you provide a file or a CID, the AI sends it to Filebase to ensure it stays on the IPFS network.

    psa_add_pinrpc_pin_add
  2. Checking status

    The agent looks up specific pins or lists your entire collection to see what is currently active.

    psa_list_pinspsa_get_pinrpc_pin_ls
  3. Updating files

    If you need to swap out a file for a newer version, the AI handles the replacement process.

    psa_replace_pin
  4. Deleting pins

    The AI removes specific CIDs from your pinning service when you tell it to clear space.

    psa_remove_pinrpc_pin_rm

Try it

Copy these to start.

Use these prompts to begin managing your IPFS data.

Starting points

Replace the bracketed text with your actual CID or file details.

Filebase Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_OPv3snjtznHNAQHV1vuWt9PMh8t0GNlwIPiwQnJT/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Filebase capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "filebase-web3-storage-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OPv3snjtznHNAQHV1vuWt9PMh8t0GNlwIPiwQnJT/mcp"
    }
  }
}
Copy into chat04
  • Pin this CID to Filebase: [insert CID here]

  • Show me a list of all my current IPFS pins.

  • Remove the pin for CID [insert CID here] from Filebase.

  • Check the status of the pin for [insert CID here].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Filebase once, then ask.

Just link your Filebase account to the Vinkius platform. Your credentials stay encrypted, and you can immediately start talking to your AI about your IPFS data.

Connect Filebase to your AI

FAQ

How the automation behaves

  • 01

    Can my AI delete files from my local computer?

    No. The AI only has permission to manage pins through the Filebase service.

  • 02

    Does the AI decide when to delete pins?

    No. The AI only removes pins when you explicitly instruct it to do so.

  • 03

    Can I use this to upload files directly from my desktop?

    The AI uses the tools to pin data via CIDs or provided content through the Filebase service.

  • 04

    How do I know if a pin was successful?

    The AI will confirm the action once the Filebase tool returns a successful response.

  • 05

    Can the AI create new IPFS nodes?

    No. This MCP is strictly for managing pins on the existing Filebase service.

  • More questions about Filebase? See everything the Filebase Connector can do

Connect Filebase to Claude, Cursor, ChatGPT & more