w3stor CLI

v0.1.0

A command-line tool for decentralized storage. Upload files, manage replications, and run as an MCP server for AI assistants -- all from your terminal.

Installation

From source:

Via npm: coming soon

Interactive Demos

Initialize

w3stor init

  w3stor init
✓ Wallet configured: 0xabc...def
✓ Connected to Filecoin Calibration
✓ Pinata API key validated
✓ SP providers loaded (3 active)
✓ x402 facilitator ready

Ready! Configuration saved to ~/.w3stor/config.json

Health Check

w3stor health

  w3stor health

Service Status
  ●  API Server        healthy    4ms
  ●  Pinata IPFS       healthy   48ms
  ●  Filecoin RPC      healthy  120ms
  ●  SP: f01234        healthy   85ms
  ●  SP: f05678        healthy   92ms
  ●  SP: f09012        healthy  110ms
  ●  x402 Facilitator  healthy   15ms

All services operational

Upload a File

w3stor upload

  w3stor upload photo.jpg --tags "robotics,research"

Pinning to IPFS...
✓ Pinned to Pinata  (1.2s)

Replicating to Filecoin SPs...
  ✓ f01234  CAR stored   (3.4s)
  ⟳ f05678  pulling...
  ⟳ f09012  pulling...

CID:  bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenora
Size: 2.4 MB
URL:  https://gateway.pinata.cloud/ipfs/bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenora
Cost: $0.0024 USDC (x402)

List Files

w3stor files

  w3stor files --status stored

  CID                                            Size     Status   SPs  Tags
  bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzd...   2.4 MB   stored   3/3  robotics,research
  bafkreiabcdefgh5eqlmn89012uvwx3456yzabcd...   890 KB   stored   3/3  dataset,v2
  bafkreiqrstuvwx6yzabcdefgh7890ijklmnopqr...   15.1 MB  stored   3/3  model-weights
  bafkreijklmnopqr8stabcdefgh9012uvwxyzabc...   4.7 MB   stored   2/3  paper,draft

4 files, 23.1 MB total

Replication Status

w3stor status

  w3stor status bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzd

CID:     bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenora
Status:  stored
Size:    2.4 MB
Created: 2026-03-28T10:15:00Z

Replication: 3/3 SPs confirmed
  ● f01234  committed  sector 5891  2026-03-28T10:18:22Z
  ● f05678  committed  sector 3204  2026-03-28T10:19:45Z
  ● f09012  committed  sector 7712  2026-03-28T10:20:01Z

Attestation: verified  tx:0xabc123...
IPNI:        indexed   3 providers

Wallet Balance

w3stor wallet

  w3stor wallet balance

Wallet: 0xabc...def (Filecoin Calibration)

Balances:
  USDC   $42.50
  FIL    0.85

Spending (30d):
  Uploads      $1.24  (52 files)
  Attestations $0.18  (3 certs)
  Total        $1.42

MCP Integration

Run w3stor as a Model Context Protocol server so AI assistants can store files directly.

Start as MCP Server

Claude Desktop Config

{  "mcpServers": {    "w3stor": {      "command": "w3stor",      "args": ["--mcp"]    }  }}

Claude Code

Agent Card

The w3stor agent exposes these tools via MCP and A2A protocols.

w3storMCP + A2A

Instructions

You are a decentralized storage agent. Upload files to IPFS for instant availability, then replicate across multiple Filecoin storage providers for permanent storage. Use x402 micropayments for paid operations.

Tools

All Commands

Command	Description	Payment
w3stor init	Configure wallet and SP providers	free
w3stor health	Check all service statuses	free
w3stor upload <file>	Upload file to IPFS + Filecoin	x402
w3stor files	List stored files	free
w3stor status <cid>	Check replication status	free
w3stor attest <cid>	Create on-chain attestation	x402
w3stor wallet balance	Show wallet balances	free
w3stor wallet fund	Fund wallet with USDC	free
w3stor --mcp	Start as MCP server	free
w3stor mcp add	Register with Claude Code	free