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; ref is the fully qualified DID/a address; 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:0xdcfa8266c094d3181cd85b68f210f2c2d149e4d9f4cfed615c5f1fabf642d673
Input
PropertyTypeDescription
offsetintegerStarting index (default 0)
limitintegerMaximum assets to return (default 100, max 1000)
typestringOptional filter: only return assets whose metadata has this 'type' field value (e.g. 'agent-definition', 'invoice')
Output
PropertyTypeDescription
offsetinteger-
limitinteger-
itemsarrayAsset summaries with id, ref, 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-4.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-4.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-4.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-4.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; ref is the fully qualified DID/a address; 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",
		"readOnly": true,
    "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, ref, 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