Filecoin Onchain Cloud MCP
MCP server for decentralized file storage on Filecoin Onchain Cloud
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
Model Context Protocol server that brings Filecoin's decentralized storage directly to your AI assistant. Store and manage your files on the Filecoin onchain cloud through natural conversation with any MCP-compatible AI tool.
@fil-b/foc-storage-mcp lets AI agents store and retrieve files on Filecoin's decentralized network through the Model Context Protocol (MCP), with automatic payment handling, CDN support, and dataset management.
Requirements:
node --version)PRIVATE_KEY - Your Filecoin wallet private key (0x...)Optional:
FILECOIN_NETWORK - mainnet (production) or calibration (testing, default)TOTAL_STORAGE_NEEDED_GiB - Default storage capacity for calculations (default: 150 GiB)PERSISTENCE_PERIOD_DAYS - Data retention duration (default: 365 days)RUNOUT_NOTIFICATION_THRESHOLD_DAYS - Balance warning threshold (default: 45 days, recommended >30)SYNAPSE_SOURCE - Source tag identifying this client to Synapse (default: foc-storage-mcp)Note: Filecoin warm storage requires 30 days paid upfront. Keep balance above 30 days to maintain service.
Jump to: Cursor | Claude Code | Claude Desktop | VS Code | Windsurf | Codex | Other
After installation, update PRIVATE_KEY in your config. Learn more
Add to .mcp.json:
{
"mcpServers": {
"foc-storage": {
"command": "npx",
"args": ["-y", "@fil-b/foc-storage-mcp"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"FILECOIN_NETWORK": "calibration"
}
}
}
}
Add to claude_desktop_config.json:
{
"mcpServers": {
"foc-storage": {
"command": "npx",
"args": ["-y", "@fil-b/foc-storage-mcp"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"FILECOIN_NETWORK": "calibration"
}
}
}
}
Create .vscode/mcp.json:
{
"servers": {
"foc-storage": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@fil-b/foc-storage-mcp"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"FILECOIN_NETWORK": "calibration"
}
}
}
}
Enable: Settings → Chat → MCP. Click "start" in mcp.json (Agent mode only). Learn more
Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"foc-storage": {
"command": "npx",
"args": ["-y", "@fil-b/foc-storage-mcp"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"FILECOIN_NETWORK": "calibration"
}
}
}
}
Restart Windsurf. Learn more
codex mcp add foc-storage -- npx -y @fil-b/foc-storage-mcp
Edit config to add environment variables. Verify: codex mcp list. Learn more
Most MCP tools support this format:
{
"mcpServers": {
"foc-storage": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@fil-b/foc-storage-mcp"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"FILECOIN_NETWORK": "calibration"
}
}
}
}
Pricing is read from the live Synapse v1 price list. Storage is billed per epoch (30 seconds) using the per-TiB monthly rate plus a recurring per-dataset service fee for non-empty datasets. Uploads can also include one-time create-dataset and add-pieces fees, and CDN egress is usage-based.
💡 Ask your agent: "How much to store 500 GiB for 6 months?"
npm test
npx tsc --noEmit
npm run build:mcp
npm run smoke:mcp:readonly
npm run build
smoke:mcp:readonly starts the built stdio server and exercises read-only MCP
tools for pricing, providers, balances, and datasets. It deliberately skips
upload, payment, withdrawal, and dataset-creation transactions; run those only
with an intentionally funded Calibration wallet.
Ask naturally in Claude, Cursor, or any MCP client:
File Operations
uploadFile - Upload files with auto-paymentgetDatasets - List all stored datasetsgetDataset - Get dataset detailscreateDataset - Create new dataset containerBalance & Payments
getBalances - Check wallet and storage metricsprocessPayment - Deposit USDFC tokensprocessWithdrawal - Withdraw a specified USDFC amount to your walletProviders & Pricing
getProviders - List storage providersestimateStoragePricing - Calculate costsgetStoragePricingInfo - Explain pricing modelsconvertStorageSize - Convert units"Check my storage balance"
"Upload presentation.pdf with CDN enabled"
"How much to store 2 TB for 1 year?"
"Create a dataset for Q4 reports"
"Show all my datasets"
Server not found: Verify npx --version, check JSON syntax, restart IDE
"PRIVATE_KEY is required": Add to env section, must start with 0x
Transaction fails: Check FIL for gas, verify network setting, confirm USDFC balance
"Invalid Version" or npm dependency errors:
npm cache clean --forcenpx clear-npx-cachenpm install -g npm@latestnpm install -g npm@10.env filesgetBalancesContributions welcome! Open an issue for major changes.
MIT © @nijoe1
Built with ❤️ by @FILBuilders for the Filecoin ecosystem
Model Context Protocol server that brings Filecoin's decentralized storage directly to your AI assistant. Store and manage your files on the Filecoin onchain cloud through natural conversation with an
ओवरव्यू
Model Context Protocol server that brings Filecoin's decentralized storage directly to your AI assistant. Store and manage your files on the Filecoin onchain cloud through natural conversation with any MCP-compatible AI tool.
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Foc Storage stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। Model Context Protocol server that brings Filecoin's decentralized storage directly to your AI assistant. Store and manage your files on the Filecoin onchain cloud through natural conversation with any MCP-compatible AI tool.