Install Filecoin Onchain Cloud

Pick your client, copy the command, done.

claude mcp add -e "PRIVATE_KEY=${PRIVATE_KEY}" filecoin-onchain-cloud -- npx -y @fil-b/foc-storage-mcp

Required:PRIVATE_KEY+ 4 optional

Environment Variables

Set these before running Filecoin Onchain Cloud.

VariableDescriptionRequired

PRIVATE_KEYYour Filecoin wallet private keyYes

FILECOIN_NETWORKFilecoin network to use (mainnet or calibration)No

TOTAL_STORAGE_NEEDED_GiBDefault storage capacity for calculationsNo

PERSISTENCE_PERIOD_DAYSData retention durationNo

RUNOUT_NOTIFICATION_THRESHOLD_DAYSBalance warning thresholdNo

Once configured, Filecoin Onchain Cloud gives your AI agent access to:

uploadFileUpload files with auto-payment

getDatasetsList all stored datasets

getDatasetGet dataset details

createDatasetCreate new datasets

After setup, try these prompts with your AI agent:

→How much would it cost to store 500 GiB of data for 6 months?

→Upload the file at ./data/project-archive.zip to my Filecoin storage.

→List all my currently stored datasets and their status.

→Create a new dataset named 'research-logs' for my upcoming project.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Node.js 18+ with npm/npx installed
PRIVATE_KEY — Your Filecoin wallet private key

Alternative installation methods

npx -y @fil-b/foc-storage-mcp

Save the docs, env vars, and workflow around Filecoin Onchain Cloud in Conare so Claude Code, Codex, and Cursor remember it next time.