English Français العربية

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

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http uxus-agent-services-wallet-lookup-entity 'https://uxus.finance/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "uxus-agent-services-wallet-lookup-entity": {
            "type": "http",
            "url": "https://uxus.finance/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. UXUS — Agent Services
  2. Services
  3. Data
  4. Development

UXUS — Agent Services

Pay-per-call primitives for AI agents, live at uxus.finance. Paid in USDC on Base via the x402 protocol — no accounts, no API keys, no signup. A funded wallet is the whole integration.

Services

EndpointPriceWhat you get
POST /api/llm$0.01LLM completion, 5-model fallback chain
GET /api/scrape$0.01URL → clean markdown/text/html
POST /api/extract$0.01messy text/URL → JSON in your schema
POST /api/embed$0.01text → 1024-dim vectors (jina-embeddings-v3)
GET /api/search$0.01live web search
GET /api/risk/pro$0.02one call, one verdict: PROCEED / CAUTION / BLOCK + summary + reasons
GET /api/risk/live/pro$0.02one-call verdict on a token's owner powers (can it still be paused, upgraded or rugged?) + reasons
GET /api/risk · /api/risk/livefreerisk score + verdict (no reasons/signals)
GET /api/lookupfreeaddress lookup for Ethereum, Base and XRPL, chain auto-detected
GET /api/entityfreeentity attribution — what is this address
GET /api/resolvefreeENS / Basenames, forward + reverse (forward-verified)
GET /api/calleridfreeshould this wallet be answered? (for XMTP/Push)
/api/shield/*freeper-user private wallet blocklist (signature-auth)
GET /api/catalog · /openapi.json · /llms.txt · /.well-known/x402.jsonfreediscovery
POST /api/mcpfreeMCP server (Streamable HTTP) over the free tools

Every risk/verdict response carries a disclaimer: this is developer-grade screening from public data (OFAC SDN list, community scam registries, on-chain reads), not legal or compliance advice.

Data

  • Sanctions come from one place: the OFAC SDN list in bad_addresses (source='ofac'), refreshed daily by /api/cron/refresh-lists (guarded — a 0-address upstream response aborts rather than wiping the table). lib/entity.ts is the only place that joins it. A non-OFAC blocklist hit is category flagged, not sanctioned, and is allowlistable.
  • Scoring fails open: if a data source needed for a verdict is unavailable and there's no list hit, the response is degraded:true / verdict CAUTION, never PROCEED.

Development

npm install
npm run dev        # http://localhost:3000
npm run build

Env (Vercel project settings):

varrequiredpurpose
DATABASE_URLyesNeon Postgres
CRON_SECRETyesgates /api/cron/*; Vercel Cron sends it as Authorization: Bearer
OPENROUTER_API_KEYfor /api/llm, /api/extract
JINA_API_KEYfor /api/embed
SERPER_API_KEY / BRAVE_API_KEYoptional/api/search (falls back to DuckDuckGo)
ETHERSCAN_API_KEYoptionalwallet history (falls back to Blockscout)
CDP_API_KEY_ID / CDP_API_KEY_SECRETfor x402 settlement

Scripts: scripts/schema*.mjs (create tables), scripts/ingest*.mjs (manual list load — the scheduled path is lib/refresh-lists.ts + scripts/ingest-entity.mjs), scripts/shield-verify.mjs (live E2E), scripts/fix-sanctions.mjs (one-shot sanctions remediation, already run).

Frequently asked questions

What is UXUS Agent Services: wallet lookup, entity labels, caller ID?

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

How do I install UXUS Agent Services: wallet lookup, entity labels, caller ID?

It runs as a remote server. In Claude Code: claude mcp add --transport http uxus-agent-services-wallet-lookup-entity 'https://uxus.finance/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does UXUS Agent Services: wallet lookup, entity labels, caller ID need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is UXUS Agent Services: wallet lookup, entity labels, caller ID open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains UXUS Agent Services: wallet lookup, entity labels, caller ID?

It is published by Dcroyalty. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.