Tool Details: asset_list

Basic Information

Tool Name:asset_list
Asset Name:List Assets
Description:List your own pinned assets (the per-user a/ namespace), with pagination. Returns summary info (id is the asset hash, plus name, type, description) per asset; use asset_get for full metadata. Filter by type for narrow searches (e.g. type='agent-definition'). Venue operations are not listed here — discover those with covia_functions / covia_adapters.
Adapter:asset
Asset Hash:0xdf257f357132f3ad6632f69c755f02399d327bfd83243fd4b0f9d2d1b902916c
Input
PropertyTypeDescription
typestringOptional filter: only return assets whose metadata has this 'type' field value (e.g. 'agent-definition', 'invoice')
offsetintegerStarting index (default 0)
limitintegerMaximum assets to return (default 100, max 1000)
Output
PropertyTypeDescription
offsetinteger-
limitinteger-
itemsarrayAsset summaries with id, name, type, description
totalintegerTotal number of matching assets

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": "asset_list",
    "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": "asset_list",
      "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": "asset_list",
        "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: 'asset_list',
        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": "List Assets",
  "description": "List your own pinned assets (the per-user a/ namespace), with pagination. Returns summary info (id is the asset hash, plus name, type, description) per asset; use asset_get for full metadata. Filter by type for narrow searches (e.g. type='agent-definition'). Venue operations are not listed here — discover those with covia_functions / covia_adapters.",
  "dateCreated": "2026-03-31T00:00:00Z",
  "operation": {
    "adapter": "asset:list",
    "toolName": "asset_list",
    "input": {
      "type": "object",
      "properties": {
        "offset": { "type": "integer", "description": "Starting index (default 0)" },
        "limit": { "type": "integer", "description": "Maximum assets to return (default 100, max 1000)" },
        "type": { "type": "string", "description": "Optional filter: only return assets whose metadata has this 'type' field value (e.g. 'agent-definition', 'invoice')" }
      }
    },
    "output": {
      "type": "object",
      "properties": {
        "items": { "type": "array", "description": "Asset summaries with id, name, type, description" },
        "total": { "type": "integer", "description": "Total number of matching assets" },
        "offset": { "type": "integer" },
        "limit": { "type": "integer" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index