Tool Details: dlfs_write

Basic Information

Tool Name:dlfs_write
Asset Name:Write DLFS File
Description:Write content to a file in a DLFS drive. Creates the file if it does not exist; overwrites if it does. Parent directories must already exist — use dlfs:mkdir first if needed. Supply exactly one of 'content' (UTF-8 text), 'value' (JSON-serialisable), 'bytes' (base64 inline), or 'asset' (content-addressed reference, streamed). Large binary uploads from clients should use the WebDAV PUT transport at /dlfs/{drive}/{path} directly.
Adapter:dlfs
Asset Hash:0x8bac5b50af01b402ef8b62ad9b72079090a2fdb0fa35e86b89ab211e0bee44b1
Input
PropertyTypeDescription
drive*stringDrive name
contentstringUTF-8 text to write
bytesstringBase64-encoded bytes to write
path*stringFile path within the drive
assetstringAsset reference to write as file content (e.g. '/a/0x1234...', DID URL). Streams binary directly — no size limit.
valueanyJSON-serialisable value to write as UTF-8 JSON
Output
PropertyTypeDescription
createdbooleanTrue if file was newly created
writtenintegerBytes written

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-3.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dlfs_write",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-3.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "dlfs_write",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-3.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "dlfs_write",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-3.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'dlfs_write',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
  "name": "Write DLFS File",
  "description": "Write content to a file in a DLFS drive. Creates the file if it does not exist; overwrites if it does. Parent directories must already exist — use dlfs:mkdir first if needed. Supply exactly one of 'content' (UTF-8 text), 'value' (JSON-serialisable), 'bytes' (base64 inline), or 'asset' (content-addressed reference, streamed). Large binary uploads from clients should use the WebDAV PUT transport at /dlfs/{drive}/{path} directly.",
  "creator": "Covia",
  "operation": {
    "adapter": "dlfs:write",
    "toolName": "dlfs_write",
    "input": {
      "type": "object",
      "properties": {
        "drive": { "type": "string", "description": "Drive name" },
        "path": { "type": "string", "description": "File path within the drive" },
        "content": { "type": "string", "description": "UTF-8 text to write" },
        "value": { "description": "JSON-serialisable value to write as UTF-8 JSON" },
        "bytes": { "type": "string", "description": "Base64-encoded bytes to write" },
        "asset": { "type": "string", "description": "Asset reference to write as file content (e.g. '/a/0x1234...', DID URL). Streams binary directly — no size limit." }
      },
      "required": ["drive", "path"]
    },
    "output": {
      "type": "object",
      "properties": {
        "written": { "type": "integer", "description": "Bytes written" },
        "created": { "type": "boolean", "description": "True if file was newly created" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index