Introduction

What is Tusky?

Tusky is agentic storage for AI. It gives your agents and applications a durable, encrypted storage layer backed by the Walrus decentralized network.

AI agents need to persist data — conversation context, generated artifacts, shared memory, backups. Tusky provides a storage API that agents can call directly via MCP tools, the TypeScript SDK, or the REST API. Files upload to a fast hot cache, sync to Walrus for decentralized durability, and stay encrypted end-to-end when they need to.

How it works

1. Upload — Your agent or application uploads files to a hot cache via MCP tools, the SDK, or presigned URLs. Files are immediately available for download.

2. Sync — A background worker syncs files from the hot cache to the Walrus decentralized storage network.

3. Durability — Once synced, files are stored across the Walrus network with no single point of failure. The hot cache copy is eventually evicted, and files can be rehydrated on demand.

Key features

MCP server Give AI agents direct access to Tusky storage. Works with Claude Code, Claude Desktop, and Cursor.

Agent skills & SKILL.md Ready-to-use SKILL.md for Claude Code. One-command install gives your agent Tusky storage skills.

End-to-end encryption Private vaults use client-side AES-256-GCM encryption. The server never sees your plaintext data or keys.

Decentralized durability Files sync to the Walrus network — no single point of failure for your data.

Fast hot cache Uploads go to S3-compatible storage first for instant availability, then sync to Walrus in the background.

Webhooks Get notified when files transition between states — hot, synced, cold, or error.

Public sharing Public vaults expose files via unauthenticated endpoints. Share files with a simple URL.

TypeScript SDK First-class SDK with typed methods for vaults, files, webhooks, and more. Zero dependencies.

Next steps

Quickstart Upload your first file in 5 minutes.

MCP Server Connect your AI agent to Tusky storage.

API Reference Explore every endpoint.