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-2.covia.ai/mcp
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "covia_write",
"arguments": {
"input": "your input here"
}
}
}
cURL Example:
curl -X POST https://venue-2.covia.ai/mcp \\
-H "Content-Type: application/json" \\
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "covia_write",
"arguments": {
"input": "your input here"
}
}
}'
Python Example:
import requests
import json
url = "https://venue-2.covia.ai/mcp"
payload = {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "covia_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-2.covia.ai/mcp';
const payload = {
jsonrpc: '2.0',
id: 1,
method: 'tools/call',
params: {
name: 'covia_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 Lattice Data",
"description": "Write a value to a writable lattice path (w/, o/, n/, t/). Examples: w/enrichments/INV-001 (persist a work product), o/my-pipeline (pin an operation for grid_run). Intermediate maps are created on demand. Writing null stores a null value (present, distinct from absent) — use covia_delete to remove an entry. Use structured values (objects/arrays) rather than serialised strings.",
"dateCreated": "2026-03-25T00:00:00Z",
"operation": {
"adapter": "covia:write",
"toolName": "covia_write",
"input": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Writable lattice path. Must start with one of: 'w/' (workspace), 'o/' (operation pins), 'n/' (agent scope), 't/' (job temp). Deep paths create intermediate maps."
},
"value": {
"description": "The value to store. Use structured values (objects/arrays/scalars) rather than serialised strings. Null stores a null value (present, distinct from absent); use covia_delete to remove an entry."
}
},
"required": ["path", "value"]
},
"output": {
"type": "object",
"properties": {
"existed": { "type": "boolean", "description": "Whether a value was already present at the path before this write: false = a new value was created, true = an existing value was replaced. A stored null counts as present." },
"pathCreated": { "type": "boolean", "description": "Present and true only if the write had to build a missing parent path (intermediate hierarchy that did not previously exist). Omitted when written into existing structure. Distinct from 'existed', which is about the leaf value." }
}
}
}
}