Tool Details: covia_append

Basic Information

Tool Name:covia_append
Asset Name:Append to Lattice Vector
Description:Append an element to a vector at a writable path (w/, o/, n/, t/). Creates the vector if it doesn't exist. Example: w/audit/trail (build an immutable event log). Errors if the target is not a vector — use covia_write to replace non-vector values.
Adapter:covia
Asset Hash:0x91fddf97095c23c2fb6bcff3007ff400244e6f0dd591489b8d3b113927ce566e
Input
PropertyTypeDescription
value*anyThe element to append. You should normally use structured values rather than serialised strings.
path*stringWritable path to a vector (creates one if missing). Must start with w/, o/, n/, or t/. Deep paths create intermediate maps.
Output
PropertyTypeDescription
newSizeintegerThe element count of the vector after the append.
indexintegerThe position the appended element landed at (newSize - 1).
pathCreatedbooleanPresent and true only if the append had to build a missing parent path (intermediate hierarchy). Omitted otherwise.
existedbooleanWhether the collection was already present before this append: false = a new single-element vector was created, true = an existing vector was extended.

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": "covia_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": "covia_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": "covia_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: 'covia_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 Lattice Vector",
	"description": "Append an element to a vector at a writable path (w/, o/, n/, t/). Creates the vector if it doesn't exist. Example: w/audit/trail (build an immutable event log). Errors if the target is not a vector — use covia_write to replace non-vector values.",
	"dateCreated": "2026-03-25T00:00:00Z",
	"operation": {
		"adapter": "covia:append",
		"toolName": "covia_append",
		"input": {
			"type": "object",
			"properties": {
				"path": {
					"type": "string",
					"description": "Writable path to a vector (creates one if missing). Must start with w/, o/, n/, or t/. Deep paths create intermediate maps."
				},
				"value": {
					"description": "The element to append. You should normally use structured values rather than serialised strings."
				}
			},
			"required": ["path", "value"]
		},
		"output": {
			"type": "object",
			"properties": {
				"existed": { "type": "boolean", "description": "Whether the collection was already present before this append: false = a new single-element vector was created, true = an existing vector was extended." },
				"index": { "type": "integer", "description": "The position the appended element landed at (newSize - 1)." },
				"newSize": { "type": "integer", "description": "The element count of the vector after the append." },
				"pathCreated": { "type": "boolean", "description": "Present and true only if the append had to build a missing parent path (intermediate hierarchy). Omitted otherwise." }
			}
		}
	}
}

Navigation

Back to adapter details

Back to all adapters

Back to index