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 'contentRef' (resolvable content, streamed). Large binary uploads from clients should use the WebDAV PUT transport at /dlfs/{drive}/{path} directly.
Adapter:dlfs
Asset Hash:0xde0f9d6527579db126a9820065481f2fe2a53fff9b086c00b3a90fcac7ba2035
Input
PropertyTypeDescription
valueanyJSON-serialisable value to write as UTF-8 JSON
drive*stringDrive name
contentstringUTF-8 text to write
bytesstringBase64-encoded bytes to write
assetstringLegacy alias for contentRef
path*stringFile path within the drive
contentRefstringResolvable content reference to stream, including an asset, file:// root path, or DLFS path. No size limit.
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 'contentRef' (resolvable content, 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" },
        "contentRef": { "type": "string", "description": "Resolvable content reference to stream, including an asset, file:// root path, or DLFS path. No size limit." },
        "asset": { "type": "string", "deprecated": true, "description": "Legacy alias for contentRef" }
      },
      "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