Tool Details: asset_get

Basic Information

Tool Name:asset_get
Asset Name:Get Asset
Description:Read asset metadata from any resolvable address (a/<hash>, o/<name>, v/ops/..., DID URL). Returns {id, exists, value}. Use asset_content for the binary payload, or covia_read if you just want the raw value without asset semantics.
Adapter:asset
Asset Hash:0x8617b2365d31e29c604c9a67b0a83b1603caf97d23b3ea7762b12d344e1f0cd1
Input
PropertyTypeDescription
idstringDeprecated alias for ref.
refstringMetadata reference. Any resolvable asset address: hex hash, a/<hash>, o/<name>, v/<path>, DID URL, or workspace path.
Output
PropertyTypeDescription
existsbooleanTrue if a metadata map was found at the address
refstringAsset reference (echoed)
idstringCompatibility alias for ref
valueobjectThe resolved metadata object (present when exists is true)

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": "asset_get",
    "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": "asset_get",
      "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": "asset_get",
        "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: 'asset_get',
        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": "Get Asset",
  "description": "Read asset metadata from any resolvable address (a/<hash>, o/<name>, v/ops/..., DID URL). Returns {id, exists, value}. Use asset_content for the binary payload, or covia_read if you just want the raw value without asset semantics.",
  "dateCreated": "2026-03-31T00:00:00Z",
	"operation": {
		"adapter": "asset:get",
		"readOnly": true,
    "toolName": "asset_get",
    "input": {
      "type": "object",
      "properties": {
        "ref": { "type": "string", "description": "Metadata reference. Any resolvable asset address: hex hash, a/<hash>, o/<name>, v/<path>, DID URL, or workspace path." },
        "id": { "type": "string", "deprecated": true, "description": "Deprecated alias for ref." }
      },
      "anyOf": [{ "required": ["ref"] }, { "required": ["id"] }]
    },
    "output": {
      "type": "object",
      "properties": {
        "ref": { "type": "string", "description": "Asset reference (echoed)" },
        "id": { "type": "string", "deprecated": true, "description": "Compatibility alias for ref" },
        "exists": { "type": "boolean", "description": "True if a metadata map was found at the address" },
        "value": { "type": "object", "description": "The resolved metadata object (present when exists is true)" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index