# Mcp Storage Server > Storacha MCP storage server - self-sovereign data for your AI applications. - **Type:** MCP server - **Install:** `agentstack add mcp-storacha-mcp-storage-server` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [storacha](https://agentstack.voostack.com/s/storacha) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [storacha](https://github.com/storacha) - **Source:** https://github.com/storacha/mcp-storage-server - **Website:** https://storacha.ai ## Install ```sh agentstack add mcp-storacha-mcp-storage-server ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Storacha MCP Storage Server A Model Context Protocol (MCP) server implementation for Storacha hot storage, allowing AI applications to store and retrieve files through a standardized interface. It enables trustless, decentralized data exchange using IPFS and CIDs, ensuring data sovereignty, verifiability, and seamless integration with agent frameworks & AI systems. ## Free Storage Options to Start 🚀 Jump-start your decentralized storage journey today! - **GitHub Users**: Sign up with your GitHub account and instantly receive **100MB of free storage** — no credit card required! - **Email Users**: Register with your email and add a credit card to unlock **5GB of free storage space**. ## Use Cases - **Document Storage & Analysis**: Securely upload and retrieve Blob documents. - **Long-term Structured Data Storage**: Maintain structured data storage optimized for longevity and accessibility. - **Data Sharing Between Agents and Systems**: Easily share data across multiple agents and diverse systems using **CIDs (Content Identifiers)**, enabling decentralized, verifiable, and efficient data exchange. - **Application Integration**: Seamlessly integrate Storacha storage retrieval into applications via the Model Context Protocol. - **AI Model Development**: Support AI models by providing reliable versioning and access to external datasets stored in Storacha. - **LLM Integration**: Enhance large language models (LLMs) by connecting directly with Storacha Storage for seamless data access. - **Web Application Backups**: Reliably store backup copies of web applications for disaster recovery. - **Machine Learning Datasets**: Efficiently manage and access large datasets used in machine learning workflows. ## Quick Installation Guide Get started with the Storacha MCP Storage Server in just a few simple steps. 1. **Clone the Repository** ```bash git clone https://github.com/storacha/mcp-storage-server.git && cd mcp-storage-server ``` 2. **Install Dependencies** ```bash pnpm install ``` 3. **Generate Keys & Delegation** - **Install the CLI** ```bash npm install -g @web3-storage/w3cli ``` - **Login to Storacha** ```bash w3 login ``` _Output:_ ``` ? How do you want to login? Via Email ❯ Via GitHub ``` _Select **Via GitHub** and authenticate with your GitHub account._ - **Create a Space** ```bash w3 space create ``` _Replace `` with a name for your new Space_. :warning: _Make sure you save the recovery key, so you can access your space from another device if needed._ - **Create a Private Key** ```bash w3 key create ``` _Output:_ ```txt AgentId: did:key:z6MkhMZRW2aoJ6BQwkpMSJu68Jgqkz1FTpr1p69cpnN43YWG PrivateKey: LMgCYLkvOc8Sm0mOL4cWFLxsWP0ZPEYrLxcQqsV93/s5RLje0BKx05muAse1Hkvh+sxUW38OcHtpiN1zxfpTJ4ht4jxV0= ``` - **Set the Agent ID & Create Delegation** ```bash w3 delegation create \ --can 'store/add' \ --can 'filecoin/offer' \ --can 'upload/add' \ --can 'space/blob/add' \ --can 'space/index/add' --base64 ``` _Replace with the AgentId from the previous step. It grants the Agent the permission to store files into the recently created space_. 4. **Configure the MCP Client** Next, configure your MCP client (such as Cursor) to use this server. Most MCP clients store the configuration as JSON in the following format: ```jsonc { "mcpServers": { "storacha-storage-server": { "command": "node", "args": ["./dist/index.js"], "env": { // The server supports `stdio`, `sse`, and `rest` modes, the default is `stdio`. "MCP_TRANSPORT_MODE": "stdio", // The Storacha Agent private key that is authorized to store data into the Space. "PRIVATE_KEY": "", // The base64 encoded delegation that proves the Agent is allowed to store data. If not set, MUST be provided for each upload request. "DELEGATION": "", }, "shell": true, "cwd": "./", }, }, } ``` _Replace `` with the PrivateKey you created in step 3. Then, replace the `` with the delegation you created in step 3._ ### REST Mode and Cloud Hosting The Storacha MCP Storage Server supports REST transport mode, which is compatible with MCP.so cloud hosting. To use REST mode: ```jsonc { "mcpServers": { "storacha-storage-server-rest": { "url": "http://localhost:3001/rest", }, }, } ``` For more information on deploying to MCP.so cloud, see the [integrations.md](https://github.com/storacha/mcp-storage-server/blob/main/docs/integrations.md#mcpso-cloud-hosting) guide. _:warning: There are several ways to configure MCP clients, please read the [integrations.md](https://github.com/storacha/mcp-storage-server/blob/main/docs/integrations.md) guide for more information._ ## Tools The Storacha MCP Storage Server provides the following tools for AI systems to interact with a decentralized storage network. ### Storage Operations #### upload Upload a file to the Storacha Network. The file must be provided as a base64 encoded string with a filename that includes the extension for MIME type detection. ```typescript interface UploadParams { // Base64 encoded file content file: string; // Filename with extension for MIME type detection name: string; // Optional: Whether to publish to Filecoin (default: false) publishToFilecoin?: boolean; // Optional: Custom delegation proof delegation?: string; // Optional: Custom gateway URL gatewayUrl?: string; } ``` #### retrieve Retrieve a file from the Storacha Network. Supported filepath formats: `CID/filename`, `/ipfs/CID/filename`, or `ipfs://CID/filename`. ```typescript interface RetrieveParams { // Path in format: CID/filename, /ipfs/CID/filename, or ipfs://CID/filename filepath: string; // Optional: Whether to use multiformat base64 encoding useMultiformatBase64?: boolean; } ``` #### identity Returns the `DIDKey` of the Storacha Agent loaded from the private key storage configuration. ```typescript interface IdentityParams { // No parameters required } ``` See the [integrations.md](https://github.com/storacha/mcp-storage-server/blob/main/docs/integrations.md) guide for detailed code examples and different integration patterns (SDK, Docker, etc). ## License MIT or Apache 2 License ## Support For support, please visit [Storacha Support](https://storacha.network) or open an issue in this repository. ## Certifications - [MCP Review](https://mcpreview.com/mcp-servers/storacha/mcp-storage-server) ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [storacha](https://github.com/storacha) - **Source:** [storacha/mcp-storage-server](https://github.com/storacha/mcp-storage-server) - **License:** Apache-2.0 - **Homepage:** https://storacha.ai Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-storacha-mcp-storage-server - Seller: https://agentstack.voostack.com/s/storacha - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.