home / mcp / fildos mcp server

FilDOS MCP Server

MCP server for FilDOS: A Secure, AI-Native, Meaning-First Decentralized Drive

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "arqoslabs-fildos-mcp": {
      "url": "https://example-mcp-server.local/mcp",
      "headers": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

FilDOS MCP Server enables AI agents to autonomously manage files on the Filecoin network. You can upload, organize, and search files on decentralized storage through straightforward MCP tool calls, making it easy to build autonomous workflows that handle data with security and persistence.

How to use

You interact with FilDOS MCP Server through MCP clients to perform folder management, file operations, and semantic search. Start by ensuring your wallet private key is available so the server can sign and authorize actions on Filecoin. Connect your MCP client to the server, then perform actions such as creating folders as NFT-backed containers with access control, uploading files to Filecoin, organizing items, and running semantic searches over your stored data using embeddings. The result is an autonomous file store that your AI agents can manage through simple tool calls.

Typical usage patterns include:

Create a folder NFT to establish a secure, access-controlled container for your project assets.
Upload new files to Filecoin and attach metadata or folder structure for easy retrieval.
Run semantic search to locate files using natural language queries or embeddings.
Manage and reorganize your storage hierarchy as your AI agents evolve their workflows.

Available tools

uploadFile

Upload a file to Filecoin and store it under a designated folder NFT with optional metadata.

createFolder

Create a folder NFT with access control to organize and protect files.

semanticSearch

Perform AI-powered semantic search over stored files using embeddings to locate relevant assets.