Filecoin Onchain Cloud MCP

⚠️ DEPRECATED — This repository is archived and no longer maintained.

👉 Use foc-cli instead.

foc-cli is the official successor. It includes everything this MCP server did, plus a full CLI, AI agent skills, and richer tooling for Filecoin Onchain Cloud.

📣 Migration Notice

@fil-b/foc-storage-mcp has been replaced by foc-cli — a single package that provides:

• ✅ MCP server — same agent-facing tools you had here, kept in sync with the SDK

• ✅ CLI — direct terminal access (npx foc-cli upload ./file.pdf)

• ✅ AI agent skills via skills.sh — works with Claude Code, Cursor, Copilot, Codex, Windsurf, and 20+ AI tools

• ✅ Active maintenance — built on the latest Synapse SDK

• ✅ Expanded features — multi-upload, redundant copies, structured output (--json, --format yaml), schema introspection, and more

If you were using this MCP server, switching takes one command.

Quick migration

Before (this archived repo):

{
  "mcpServers": {
    "foc-storage": {
      "command": "npx",
      "args": ["-y", "@fil-b/foc-storage-mcp"],
      "env": { "PRIVATE_KEY": "0x...", "FILECOIN_NETWORK": "calibration" }
    }
  }
}

After (foc-cli):

# Auto-detect your agent and install
npx foc-cli mcp add

# Or target a specific agent
npx foc-cli mcp add --agent claude-code

Or install as an AI agent skill (recommended for Claude Code, Cursor, and similar):

npx skills add FIL-Builders/foc-cli

See the foc-cli README for full setup and command reference.

Tool mapping

Every tool from this MCP server has an equivalent in foc-cli:

About this archive

The sections below describe @fil-b/foc-storage-mcp as it was when this repository was active. They are preserved for reference only — no further updates, bug fixes, or security patches will be issued. Please migrate to foc-cli.

What it was

@fil-b/foc-storage-mcp provided AI agents with access to Filecoin's decentralized storage network through the Model Context Protocol (MCP). It supported file upload with automatic USDFC payment handling, dataset organization, CDN-backed retrieval, and cost estimation.

Original tools (10)

File operations

• uploadFile — Upload files with auto-payment

• getDatasets — List all stored datasets

• getDataset — Get dataset details

• createDataset — Create new dataset container

Balance & payments

• getBalances — Check wallet and storage metrics

• processPayment — Deposit USDFC tokens

Providers & pricing

• getProviders — List storage providers

• estimateStoragePricing — Calculate costs

• getStoragePricingInfo — Explain pricing models

• convertStorageSize — Convert units

Original configuration

Requirements: Node.js >= 20.10.0, PRIVATE_KEY env var (Filecoin wallet, 0x...)

Optional env vars:

• FILECOIN_NETWORK — mainnet or calibration (default)

• TOTAL_STORAGE_NEEDED_GiB — default 150

• PERSISTENCE_PERIOD_DAYS — default 365

• RUNOUT_NOTIFICATION_THRESHOLD_DAYS — default 45 (recommended >30; Filecoin warm storage requires 30 days paid upfront)

Original pricing

Storage was billed at $2.50/TiB/month, paid per-epoch (30s), with a minimum of $0.06/month. Example: 150 GiB for 1 year ≈ 0.44 USDFC.

These economics are unchanged in foc-cli, which uses the same Filecoin Warm Storage Service (FWSS) under the hood.

Links

• 🚀 Replacement: FIL-Builders/foc-cli

• 📦 NPM (replacement): foc-cli

• 📚 Filecoin Onchain Cloud Docs

• 🤖 MCP Protocol

• 🛠 Skills.sh

License

MIT © @nijoe1

Built with ❤️ by @FILBuilders for the Filecoin ecosystem.