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

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Free wallet lookup, ENS, labels, caller ID. Paid x402: search, scrape, XRP yield and lending grades

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "UXUS Agent Services: wallet lookup, entity labels, caller ID": {
      "url": "https://uxus.finance/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• search_web

  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).

  Parameters:

  • query (required) — string — Search query. Required.
  • page — integer — 1-based result page. Optional.
  • count — integer — Number of results, 1-20. Default 10.
  • device — string — Forwarded to the upstream provider if set; not confirmed to change results on every provider. Optional.
  • country — string — 2-letter country code. Optional.
  • language — string — 2+ letter language code. Optional.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• scrape_url

  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).

  Parameters:

  • url (required) — string — Absolute http/https URL to fetch. Required.
  • format — string — Output format. Default markdown.
  • max_chars — integer — Truncation limit. Default 40000, max 120000.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• yield_grade

  A-F risk grade for one way to earn on XRP or RLUSD, from the XRP Yield Desk (xrplhub.io/yield): XRPL AMM pools, Doppler vaults, Firelight stXRP and other Flare FXRP products, RLUSD and XRP DeFi pools, and exchange earn programs. Returns the rate, size, lockup and withdrawal terms, who holds the keys, chain, age, audits, the data source with its timestamp, and every rule that moved the grade. General information, not advice; the products graded pay nothing. This is a PAID x402 call: $0.02 USDC on Base at GET /api/yield/grade. This tool returns the payment resource to call; it does not compute the grade. Find ids for free at https://www.xrplhub.io/api/yield/options. Params: id (option id, required).

  Parameters:

  • id (required) — string — Option id (slug) from https://www.xrplhub.io/api/yield/options, e.g. doppler-xrp-vault-xrpl. Required.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lending_grade

  A-F risk grade for one XRP Ledger lending vault or loan broker, from on-ledger data only (size, utilization, first-loss cover ratio, late/impaired/defaulted loans, unrealized loss, realized yield), with every rule that moved the grade. Not a credit rating. This is a PAID x402 call: $0.02 USDC on Base at GET /api/lending/grade. This tool returns the payment resource to call; it does not compute the grade. NOT LIVE YET: it goes live when XRPL lending (the LendingProtocol and SingleAssetVault amendments) is enabled on mainnet. Until then this tool returns available:false and GET /api/lending/grade returns 503 with no charge. Params: id (64-hex Vault or LoanBroker ID, required); type (vault | broker, optional).

  Parameters:

  • id (required) — string — 64-hex ledger ID of an XRPL Vault or LoanBroker. Required.
  • type — string — Optional; detected when omitted.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookup_wallet

  Address lookup for Ethereum and Base 0x addresses and XRPL r-addresses, 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.

  Parameters:

  • address (required) — string — EVM 0x address or XRPL classic r-address. Required.
  • chain — string — Optional EVM history hint. Default base.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• resolve_name

  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.

  Parameters:

  • q (required) — string — An ENS/Basename name, an EVM 0x address, or an XRPL classic r-address. Required.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• check_entity

  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.

  Parameters:

  • address (required) — string — 0x EVM address. Required.
  • chain — string — Default base.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• caller_id

  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.

  Parameters:

  • address (required) — string — 0x EVM address. Required.
  • chain — string — Default base.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• health

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.