UXUS Agent Services: wallet lookup, entity labels, caller ID

Live web search: ranked results plus Google's answer box, knowledge graph, people-also-ask and related searches when the Google-backed provider answers. This is a PAID x402 call: $0.01 USDC on Base at GET /api/search. This tool returns the payment resource to call; it does not run the search. Params: query (string, required); count (integer 1-20, default 10); country/language/page/device (optional).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query. Required."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Number of results, 1-20. Default 10."
    },
    "country": {
      "type": "string",
      "description": "2-letter country code. Optional."
    },
    "language": {
      "type": "string",
      "description": "2+ letter language code. Optional."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based result page. Optional."
    },
    "device": {
      "type": "string",
      "description": "Forwarded to the upstream provider if set; not confirmed to change results on every provider. Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Any web page as clean, LLM-ready markdown, text or html. This is a PAID x402 call: $0.01 USDC on Base at GET /api/scrape. This tool returns the payment resource to call; it does not fetch the page. Params: url (absolute http/https URL, required); format (markdown | text | html, default markdown); max_chars (integer, default 40000, max 120000).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Absolute http/https URL to fetch. Required."
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "text",
        "html"
      ],
      "default": "markdown",
      "description": "Output format. Default markdown."
    },
    "max_chars": {
      "type": "integer",
      "default": 40000,
      "maximum": 120000,
      "description": "Truncation limit. Default 40000, max 120000."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Universal address lookup — any address, any chain, auto-detected. Params: address (EVM 0x address or XRPL classic r-address, required); chain (optional EVM history hint: base default, or ethereum). Detects EVM vs XRPL from the format. Returns one normalized envelope: { address, chain, chain_detected, exists, risk_score, risk_level, verdict, flags, entity, name }. Free. For a fast first-pass check on a counterparty wallet.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "EVM 0x address or XRPL classic r-address. Required."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum"
      ],
      "description": "Optional EVM history hint. Default base."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Bidirectional name <-> address resolution for ENS (name.eth) and Basenames (name.base.eth). Param: q (an ENS/Basename name, an EVM 0x address, or an XRPL r-address, required). Auto-detects direction. Reverse records are forward-verified against the address to stop name spoofing. Returns { query, kind, namespace, chain, resolved, address, name, sources }. XRPL .xrp names are detected but resolved:false (no canonical registry). Free.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "An ENS/Basename name, an EVM 0x address, or an XRPL classic r-address. Required."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Entity attribution — what IS this address, not who owns it. Params: address (0x EVM address, required); chain (base default, or ethereum). Returns { address, chain, is_known, label, category }. category is one of sanctioned, mixer, exchange, bridge, dex_router, scam, drainer, phishing, flagged, token_contract, protocol, unknown. "sanctioned" is set only when the address is on the OFAC SDN list (the same source /api/risk uses); a non-OFAC blocklist hit is "flagged". Sourced from OFAC, ScamSniffer, MEW, eth-labels and curated Base/Tornado sets. Never guesses. Free.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "0x EVM address. Required."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum"
      ],
      "description": "Default base."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Should this wallet be answered? For wallet messaging (XMTP, Push), which has no spam filter. Params: address (0x EVM address, required); chain (base default, or ethereum). Composes entity attribution + risk score + on-chain history + forward-verified name into ANSWER | SCREEN | BLOCK with reasons[] and a confidence flag. BLOCK on sanctioned/drainer/phishing/scam/mixer or risk verdict BLOCK; SCREEN is the default for unknown addresses. Free.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "0x EVM address. Required."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum"
      ],
      "description": "Default base."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Service health check. No parameters. Returns { ok, service, time, upstream } — confirms the uxus.finance API is reachable. Free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}