home / mcp / mcp ipfs server

MCP IPFS Server

🪐 MCP IPFS Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "alexbakers-mcp-ipfs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ipfs"
      ],
      "env": {
        "W3_LOGIN_EMAIL": "YOUR_EMAIL"
      }
    }
  }
}

You can run the MCP IPFS Server to interact with storacha.network through MCP clients by wrapping the web3 storage CLI commands. This server lets language models and other MCP clients manage spaces, upload and retrieve data, handle delegations, and perform advanced storage tasks in a seamless, MCP-friendly way.

How to use

Configure your MCP client to connect to the server, then choose from the available MCP tools to perform common tasks such as authenticating, managing spaces, uploading data, sharing access, and handling delegations and proofs. The server exposes tools that wrap the underlying w3 CLI, so you can issue MCP-style commands to accomplish storacha.network operations without leaving your preferred client environment.

How to install

Prerequisites ensure you can run the server and connect MCP clients. You will set up Node.js, install the w3 CLI, and prepare environment variables for authentication.

Additional sections

Prerequisites include Node.js version 22.0.0 or higher and the w3 CLI, which you install and log in to using your email. You will run or build the MCP IPFS Server, then start it so MCP clients can connect and use the wrapped w3 commands.

Available tools

w3_login

Authenticate the w3 CLI user and establish authorization for storacha.network access.

w3_reset

Reset the current authentication state for the user.

w3_account_ls

List accounts to verify which accounts are authorized.

w3_space_ls

List available Storacha spaces.

w3_space_use

Switch the active space you are working with.

w3_space_info

Get detailed information about a specific space.

w3_space_add

Add a new space under storacha.network.

w3_space_provision

Provision a space with required resources and settings.

w3_up

Upload data to a space.

w3_ls

List objects in storage.

w3_rm

Remove data or objects from storage.

w3_open

Generate a sharable w3s.link URL for access.

w3_delegation_create

Create a delegation for access control.

w3_delegation_ls

List existing delegations.

w3_delegation_revoke

Revoke a delegation.

w3_proof_add

Add a cryptographic proof for an object or action.

w3_proof_ls

List proofs associated with a resource.

w3_key_create

Create keys for authentication or access.

w3_bridge_generate_tokens

Generate tokens for bridging authentication or access.

w3_can_blob_add

Add a blob to can storage.

w3_can_store_add

Store data in can-based storage.

w3_plan_get

Retrieve billing or plan information.

w3_coupon_create

Create a coupon for storage discounts.

w3_usage_report

Fetch usage and billing details.