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:0xb3db2c32795d21236a2d13d1203fff1a3f4490496adfd423dd774a690a95b79b
Input
PropertyTypeDescription
path*stringWritable path to a vector (creates one if missing). Must start with w/, o/, n/, or t/. Deep paths create intermediate maps.
value*anyThe element to append. You should normally use structured values rather than serialised strings.
Output
PropertyTypeDescription
newSizeintegerThe element count of the vector after the append.
pathCreatedbooleanPresent and true only if the append had to build a missing parent path (intermediate hierarchy). Omitted otherwise.

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://api.getmine.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://api.getmine.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://api.getmine.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://api.getmine.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": {
				"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