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": "agent_info",
"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": "agent_info",
"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": "agent_info",
"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: 'agent_info',
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": "Agent Info",
"description": "Get a lightweight summary of an agent: status, canonical config, pending-task count, timeline length, unavailable configured tools, and any suspension error. For durable detail inspect g/{agentId}: config is at g/{agentId}/config, audit runs at g/{agentId}/timeline, and conversations at g/{agentId}/sessions/<sessionId>/frames. Framework-managed records are read-only; use agent:update for config changes and agent:context for the exact next provider input.",
"dateCreated": "2026-04-01T00:00:00Z",
"operation": {
"adapter": "agent:info",
"readOnly": true,
"toolName": "agent_info",
"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>" }
},
"required": ["agentId"]
},
"output": {
"type": "object",
"properties": {
"agentId": { "type": "string" },
"address": { "type": "string", "description": "Canonical <ownerDID>/g/<agentId> address" },
"status": { "type": "string", "description": "SLEEPING, RUNNING, SUSPENDED, or TERMINATED" },
"config": { "type": "object", "description": "Canonical merged agent config: transition/provider selection, prompt, tools, skills, context, loads, caps, outputs, and definition provenance where present" },
"agent": { "type": "object", "description": "External adapter definition when present; absent for the native Covia agent runtime." },
"timelineLength": { "type": "integer", "description": "Number of completed runs" },
"tasks": { "type": "integer", "description": "Number of pending tasks" },
"awaiting": {
"type": "object",
"description": "Pending jobs awaiting input or authorisation; derived on read from this agent's pending job references, independent of lifecycle status. Does not imply the viewer is the intended responder.",
"properties": {
"input": { "type": "integer", "minimum": 0 },
"auth": { "type": "integer", "minimum": 0 }
},
"required": ["input", "auth"]
},
"unavailableTools": { "type": "array", "description": "Configured operation tools currently missing or unreadable, with a reason for each" },
"error": { "type": "string", "description": "Last error message, if suspended" }
}
}
}
}