English Français العربية

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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).

الأسئلة الشائعة

ما هو 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

كيف أثبّت UXUS Agent Services: wallet lookup, entity labels, caller ID؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http uxus-agent-services-wallet-lookup-entity 'https://uxus.finance/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج UXUS Agent Services: wallet lookup, entity labels, caller ID إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل UXUS Agent Services: wallet lookup, entity labels, caller ID مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون UXUS Agent Services: wallet lookup, entity labels, caller ID؟

ينشره Dcroyalty. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.