Tool Details: file_append

Basic Information

Tool Name:file_append
Asset Name:Append to File
Description:Append bytes to a file under a configured filesystem root, creating the file if it does not exist. Supply exactly one of 'content' (UTF-8 text), 'value' (JSON-serialised), 'bytes' (base64 inline), or 'asset' (CAS reference, streamed). Read-only roots reject writes.
Adapter:file
Asset Hash:0x731191d55b59b401d3e10ad31c18df7c9922a3559eeb50f6802c8d4029722e8d
Input
PropertyTypeDescription
root*stringConfigured root name
contentstringUTF-8 text to append
bytesstringBase64-encoded bytes to append
path*stringFile path relative to the root
assetstringAsset reference to stream as appended content
valueanyJSON-serialisable value to append as UTF-8 JSON
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-3.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-3.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-3.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-3.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 bytes to a file under a configured filesystem root, creating the file if it does not exist. Supply exactly one of 'content' (UTF-8 text), 'value' (JSON-serialised), 'bytes' (base64 inline), or 'asset' (CAS reference, streamed). Read-only roots reject writes.",
  "creator": "Covia",
  "operation": {
    "adapter": "file:append",
    "toolName": "file_append",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Configured root name" },
        "path": { "type": "string", "description": "File path relative to the root" },
        "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" },
        "asset": { "type": "string", "description": "Asset reference to stream as appended content" }
      },
      "required": ["root", "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