Skip to main content
Glama

Find tokenized assets

find_assets
Read-onlyIdempotent

Searches the UNIALL index of tokenized real-world assets by free-text query (name, ticker, issuer) and filters for category, chain, issuer, underlying ticker, AUM, transfer standard and verification. Use underlying (e.g. QQQ) to return only wrappers of that spot underlier — leveraged/inverse products (TQQQ, SQQQ, PSQ, QLD, QQQI) are excluded. Results include verified and unverified assets; verified assets rank first. Set verified_only=true to return verified assets only. Category keys: equities, real_estate, etfs_funds, commodities_precious_metals, private_credit, treasuries (includes money market funds), money_market, commodities_other, structured_products, collectibles, corporate_bonds.

Input Schema

NameRequiredDescriptionDefault
chainNoBlockchain name, e.g. ethereum, base, polygon, solana
limitNoMax matches to return (default 5).
queryNoFree-text search over asset name, symbol, underlying name/ticker, and issuer name (e.g. BUIDL, BlackRock).
issuerNoIssuer name or alias, case-insensitive, e.g. BlackRock, Ondo
categoryNoAsset category key or list of keys. One of: equities, real_estate, etfs_funds, commodities_precious_metals, private_credit, treasuries, money_market, commodities_other, structured_products, collectibles, corporate_bonds.
underlyingNoSpot underlying ticker (e.g. QQQ). Matches stored underlying fields and issuer-suffixed symbols (QQQON, QQQx, QQQB, RQQQ). Excludes leveraged/inverse products of that underlier.
min_aum_usdNoMinimum assets under management in USD
verified_onlyNoWhen true, only verified assets. Default false — includes indexed (unverified) assets; verified still rank first.
transfer_standardNoOn-chain transfer restriction standard filter (e.g. securitize-ds, erc1404).

Output Schema

NameRequiredDescriptionDefault
factsYesSourced scalar facts. Each item has field, value, source_url, source_type, as_of.
answerYesShort natural-language summary of the result.
assetsNoMatched assets when applicable (find_assets). Empty or omitted for stats/summary tools.
disclaimerYesFixed data-only disclaimer; not investment advice.
request_idYesRequest correlation id.
index_as_ofYesISO timestamp for index freshness.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / underlying
      Added value: +{
      +  "description": "Spot underlying ticker (e.g. QQQ). Matches stored underlying fields and issuer-suffixed symbols (QQQON, QQQx, QQQB, RQQQ). Excludes leveraged/inverse products of that underlier.",
      +  "type": "string"
      +}
  2. Changed6 schema fields changed
    • changedInput schema / properties / chain / description
      Previous value: -"Chain slug filter (e.g. ethereum, base, polygon)."New value: +"Blockchain name, e.g. ethereum, base, polygon, solana"
    • changedInput schema / properties / issuer / description
      Previous value: -"Issuer alias or brand name (e.g. BlackRock → BUIDL issuer). Does not match Ondo/xStock wrappers that mention the brand."New value: +"Issuer name or alias, case-insensitive, e.g. BlackRock, Ondo"
    • changedInput schema / properties / min_aum_usd / description
      Previous value: -"Minimum sourced AUM in USD."New value: +"Minimum assets under management in USD"
    • changedInput schema / properties / query / description
      Previous value: -"Free-text search over asset name, symbol, underlying name/ticker, and issuer name."New value: +"Free-text search over asset name, symbol, underlying name/ticker, and issuer name (e.g. BUIDL, BlackRock)."
    • changedInput schema / properties / transfer_standard / description
      Previous value: -"On-chain transfer restriction standard filter."New value: +"On-chain transfer restriction standard filter (e.g. securitize-ds, erc1404)."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "answer": {
      +      "description": "Short natural-language summary of the result.",
      +      "type": "string"
      +    },
      +    "assets": {
      +      "description": "Matched assets when applicable (find_assets). Empty or omitted for stats/summary tools.",
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "aum_usd": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "category": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "chains": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "issuer": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "symbol": {
      +            "type": "string"
      +          },
      +          "transfer_standard": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "uniall_url": {
      +            "type": "string"
      +          },
      +          "verified": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "disclaimer": {
      +      "description": "Fixed data-only disclaimer; not investment advice.",
      +      "type": "string"
      +    },
      +    "facts": {
      +      "description": "Sourced scalar facts. Each item has field, value, source_url, source_type, as_of.",
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "as_of": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "field": {
      +            "type": "string"
      +          },
      +          "source_type": {
      +            "type": "string"
      +          },
      +          "source_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "value": {}
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "index_as_of": {
      +      "description": "ISO timestamp for index freshness.",
      +      "type": "string"
      +    },
      +    "request_id": {
      +      "description": "Request correlation id.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "answer",
      +    "facts",
      +    "disclaimer",
      +    "index_as_of",
      +    "request_id"
      +  ],
      +  "type": "object"
      +}
  3. Changed14 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedInput schema / properties / category / anyOf
      Removed value: -[
      -  {
      -    "enum": [
      -      "equities",
      -      "real_estate",
      -      "etfs_funds",
      -      "commodities_precious_metals",
      -      "private_credit",
      -      "treasuries",
      -      "money_market",
      -      "commodities_other",
      -      "structured_products",
      -      "collectibles",
      -      "corporate_bonds"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "$ref": "#/properties/category/anyOf/0"
      -    },
      -    "maxItems": 11,
      -    "minItems": 1,
      -    "type": "array"
      -  }
      -]
    • addedInput schema / properties / category / description
      Added value: +"Asset category key or list of keys. One of: equities, real_estate, etfs_funds, commodities_precious_metals, private_credit, treasuries, money_market, commodities_other, structured_products, collectibles, corporate_bonds."
    • addedInput schema / properties / category / oneOf
      Added value: +[
      +  {
      +    "enum": [
      +      "equities",
      +      "real_estate",
      +      "etfs_funds",
      +      "commodities_precious_metals",
      +      "private_credit",
      +      "treasuries",
      +      "money_market",
      +      "commodities_other",
      +      "structured_products",
      +      "collectibles",
      +      "corporate_bonds"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "enum": [
      +        "equities",
      +        "real_estate",
      +        "etfs_funds",
      +        "commodities_precious_metals",
      +        "private_credit",
      +        "treasuries",
      +        "money_market",
      +        "commodities_other",
      +        "structured_products",
      +        "collectibles",
      +        "corporate_bonds"
      +      ],
      +      "type": "string"
      +    },
      +    "maxItems": 11,
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / chain / description
      Added value: +"Chain slug filter (e.g. ethereum, base, polygon)."
    • addedInput schema / properties / issuer / description
      Added value: +"Issuer alias or brand name (e.g. BlackRock → BUIDL issuer). Does not match Ondo/xStock wrappers that mention the brand."
    • addedInput schema / properties / limit / description
      Added value: +"Max matches to return (default 5)."
    • addedInput schema / properties / min_aum_usd / description
      Added value: +"Minimum sourced AUM in USD."
    • addedInput schema / properties / query / description
      Added value: +"Free-text search over asset name, symbol, underlying name/ticker, and issuer name."
    • removedInput schema / properties / query / maxLength
      Removed value: -200
    • removedInput schema / properties / query / minLength
      Removed value: -1
    • addedInput schema / properties / transfer_standard / description
      Added value: +"On-chain transfer restriction standard filter."
    • changedInput schema / properties / transfer_standard / enum
      Previous value: -[
      -  "permissionless",
      -  "erc1404",
      -  "securitize-ds",
      -  "whitelist"
      -]New value: +[
      +  "erc1404",
      +  "securitize-ds",
      +  "whitelist",
      +  "permissionless"
      +]
    • addedInput schema / properties / verified_only / description
      Added value: +"When true, only verified assets. Default false — includes indexed (unverified) assets; verified still rank first."
  4. Changed3 schema fields changed
    • addedInput schema / properties / category / anyOf
      Added value: +[
      +  {
      +    "enum": [
      +      "equities",
      +      "real_estate",
      +      "etfs_funds",
      +      "commodities_precious_metals",
      +      "private_credit",
      +      "treasuries",
      +      "money_market",
      +      "commodities_other",
      +      "structured_products",
      +      "collectibles",
      +      "corporate_bonds"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "$ref": "#/properties/category/anyOf/0"
      +    },
      +    "maxItems": 11,
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / category / type
      Removed value: -"string"
    • addedInput schema / properties / query
      Added value: +{
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
  5. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, and the description adds genuine behavior beyond them: default result set mixes verified and unverified with verified ranked first, and leveraged/inverse products are excluded from `underlying` matches. It does not discuss result volume beyond the schema's limit or what an empty match means, but the ranking and inclusion semantics are the parts an agent could not otherwise infer.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and the highest-value caveat (underlying exclusions) before the enumeration. The trailing list of eleven category keys duplicates the schema enum verbatim and is the least efficient sentence, though it remains scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return shape needn't be explained, and all nine parameters are documented in-schema. For a multi-filter search tool the definition covers the decisions an agent must make; only cross-tool routing to siblings is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3 and the description largely restates it — the QQQ example and the leveraged/inverse exclusion appear in both places. The one real addition is the parenthetical 'treasuries (includes money market funds)', which disambiguates two overlapping enum values, but that is a small increment over an already complete schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource: 'Searches the UNIALL index of tokenized real-world assets', then enumerates both the free-text fields and the filter dimensions. It is clearly distinguishable from siblings like get_index_stats and compare_underlying, which do aggregate/comparison work rather than asset lookup.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete decision guidance for ambiguous cases: use `underlying` for spot wrappers, set verified_only=true when unverified assets must be excluded, and notes verified assets rank first by default. It does not explicitly route the agent away from this tool toward a sibling (e.g. get_asset_summary for a known asset), so it stops short of full when/when-not coverage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources