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-1.covia.ai/mcp
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "agent_cancel_task",
"arguments": {
"input": "your input here"
}
}
}
cURL Example:
curl -X POST https://venue-1.covia.ai/mcp \\
-H "Content-Type: application/json" \\
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "agent_cancel_task",
"arguments": {
"input": "your input here"
}
}
}'
Python Example:
import requests
import json
url = "https://venue-1.covia.ai/mcp"
payload = {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "agent_cancel_task",
"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-1.covia.ai/mcp';
const payload = {
jsonrpc: '2.0',
id: 1,
method: 'tools/call',
params: {
name: 'agent_cancel_task',
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": "Cancel Agent Task",
"description": "Removes a pending task from an agent's task queue. The task will no longer be presented to the agent's transition function. Use this to clean up stuck or unwanted tasks. An optional reason becomes the cancelled task job's error, so whoever is waiting on it sees why.",
"dateCreated": "2026-03-11T00:00:00Z",
"operation": {
"adapter": "agent:cancelTask",
"internal": false,
"toolName": "agent_cancel_task",
"input": {
"type": "object",
"properties": {
"agentId": { "type": "string", "description": "Agent reference: a bare name for the caller's agent, g/<id>, /g/<id>, or <ownerDID>/g/<id>" },
"taskId": { "type": "string", "description": "Hex ID of the task to cancel" },
"reason": { "type": "string", "description": "Optional: why the task is cancelled — recorded as the task job's error" }
},
"required": ["agentId", "taskId"]
},
"output": {
"type": "object",
"properties": {
"agentId": { "type": "string" },
"address": { "type": "string", "description": "Canonical <ownerDID>/g/<agentId> address" },
"taskId": { "type": "string" },
"cancelled": { "type": "boolean" }
}
}
}
}