Tool Details: file_append

Basic Information

Tool Name:file_append
Asset Name:Append to File
Description:Append to a file under a configured filesystem root or at an authorised DLFS path, creating it if absent. Supply exactly one of content, value, bytes, or contentRef.
Adapter:file
Asset Hash:0x4b7190acda9537cfb94af8a3a89e327ef5b867c30e3dcafd3e5b54c6e954766c
Input
PropertyTypeDescription
contentstringUTF-8 text to append
bytesstringBase64-encoded bytes to append
assetstringLegacy alias for contentRef
valueanyJSON-serialisable value to append as UTF-8 JSON
path*stringPath relative to root or a canonical DLFS file path
rootstringConfigured root name; omit for a canonical DLFS path
contentRefstringResolvable content reference to stream, including an asset, file:// root path, or DLFS path
Output
PropertyTypeDescription
appendedintegerBytes appended
createdbooleanTrue if the file was newly created

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-test.covia.ai/mcp

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

url = "https://venue-test.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "file_append",
        "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-test.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'file_append',
        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": "Append to File",
  "description": "Append to a file under a configured filesystem root or at an authorised DLFS path, creating it if absent. Supply exactly one of content, value, bytes, or contentRef.",
  "creator": "Covia",
  "operation": {
    "adapter": "file:append",
    "readOnly": false,
    "toolName": "file_append",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Configured root name; omit for a canonical DLFS path" },
        "path": { "type": "string", "description": "Path relative to root or a canonical DLFS file path" },
        "content": { "type": "string", "description": "UTF-8 text to append" },
        "value": { "description": "JSON-serialisable value to append as UTF-8 JSON" },
        "bytes": { "type": "string", "description": "Base64-encoded bytes to append" },
        "contentRef": { "type": "string", "description": "Resolvable content reference to stream, including an asset, file:// root path, or DLFS path" },
        "asset": { "type": "string", "deprecated": true, "description": "Legacy alias for contentRef" }
      },
      "required": ["path"]
    },
    "output": {
      "type": "object",
      "properties": {
        "appended": { "type": "integer", "description": "Bytes appended" },
        "created": { "type": "boolean", "description": "True if the file was newly created" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index