UXUS Agent Services MCP server
Commit Oct 16, 2026Enables AI agents to perform wallet lookups, entity attribution, ENS resolution, and risk assessment using pay-per-call primitives.
Also known as Dcroyalty/cryptorisk-api, cryptorisk-api
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.4.0
- Last commit
- Oct 16, 2026
- License
- —
What is UXUS Agent Services MCP?
UXUS Agent Services enables AI agents to perform wallet lookups, entity attribution, ENS resolution, and risk assessment using pay-per-call primitives.
Summary generated from the project's README
About UXUS Agent Services MCP server
UXUS Agent Services provides a suite of pay-per-call primitives designed specifically for AI agents. This MCP server allows developers to integrate blockchain intelligence and web processing tools without the need for traditional accounts or API keys. Instead, the system uses the x402 protocol to settle payments in USDC on the Base network, meaning a funded wallet serves as the entire integration mechanism.
Users can access free tools for address lookups across Ethereum, Base, and XRPL, as well as ENS and Basenames resolution. For more advanced tasks, the service offers paid endpoints for LLM completions, web scraping, data extraction, and live web searches. Risk assessment is a core feature, providing verdicts like PROCEED, CAUTION, or BLOCK based on public data such as the OFAC SDN list. The server also includes specialized tools for entity attribution and caller ID functionality for XMTP or Push communications.
What you can do with it
- 1Blockchain identity resolutionAn AI agent can resolve an ENS or Basename to find the associated wallet address.
- 2Automated risk screeningA developer can request a professional risk verdict to determine if a transaction should be blocked or proceed.
- 3Web data extractionAn agent can transform messy website content into structured JSON data using a specific schema.
- 4Wallet attributionThe service can identify what kind of entity a specific blockchain address represents.
Written from the project's README. Every use case is checked against a quote from it.
How to install UXUS Agent Services MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall UXUS Agent Services MCP in Claude Code
$ claude mcp add --transport http cryptorisk-api https://uxus.finance/api/mcpInstall UXUS Agent Services MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cryptorisk-api": {
"url": "https://uxus.finance/api/mcp"
}
}
}Install UXUS Agent Services MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cryptorisk-api": {
"type": "http",
"url": "https://uxus.finance/api/mcp"
}
}
}Install UXUS Agent Services MCP in VS Code CLI
$ code --add-mcp '{"name":"cryptorisk-api","type":"http","url":"https://uxus.finance/api/mcp"}'Install UXUS Agent Services MCP in Codex
$ codex mcp add cryptorisk-api --url https://uxus.finance/api/mcpInstall UXUS Agent Services MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cryptorisk-api] url = "https://uxus.finance/api/mcp"
Install UXUS Agent Services MCP in Gemini CLI
$ gemini mcp add -s user --transport http cryptorisk-api https://uxus.finance/api/mcpInstall UXUS Agent Services MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cryptorisk-api": {
"url": "https://uxus.finance/api/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledcroyalty/cryptorisk-api is public and reachablegithub.com/dcroyalty/cryptorisk-api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-16github.com/dcroyalty/cryptorisk-api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: HTTP 402Finding
README
View on GitHubUXUS — 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
| Endpoint | Price | What you get |
|---|---|---|
POST /api/llm |
$0.01 | LLM completion, 5-model fallback chain |
GET /api/scrape |
$0.01 | URL → clean markdown/text/html |
POST /api/extract |
$0.01 | messy text/URL → JSON in your schema |
POST /api/embed |
$0.01 | text → 1024-dim vectors (jina-embeddings-v3) |
GET /api/search |
$0.01 | live web search |
GET /api/risk/pro |
$0.02 | one call, one verdict: PROCEED / CAUTION / BLOCK + summary + reasons |
GET /api/risk/live/pro |
$0.02 | one-call verdict on a token's owner powers (can it still be paused, upgraded or rugged?) + reasons |
GET /api/risk · /api/risk/live |
free | risk score + verdict (no reasons/signals) |
GET /api/lookup |
free | address lookup for Ethereum, Base and XRPL, chain auto-detected |
GET /api/entity |
free | entity attribution — what is this address |
GET /api/resolve |
free | ENS / Basenames, forward + reverse (forward-verified) |
GET /api/callerid |
free | should this wallet be answered? (for XMTP/Push) |
/api/shield/* |
free | per-user private wallet blocklist (signature-auth) |
GET /api/catalog · /openapi.json · /llms.txt · /.well-known/x402.json |
free | discovery |
POST /api/mcp |
free | MCP 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.tsis the only place that joins it. A non-OFAC blocklist hit is categoryflagged, notsanctioned, 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/ verdictCAUTION, neverPROCEED.
Development
npm install
npm run dev # http://localhost:3000
npm run build
Env (Vercel project settings):
| var | required | purpose |
|---|---|---|
DATABASE_URL |
yes | Neon Postgres |
CRON_SECRET |
yes | gates /api/cron/*; Vercel Cron sends it as Authorization: Bearer |
OPENROUTER_API_KEY |
for /api/llm, /api/extract |
|
JINA_API_KEY |
for /api/embed |
|
SERPER_API_KEY / BRAVE_API_KEY |
optional | /api/search (falls back to DuckDuckGo) |
ETHERSCAN_API_KEY |
optional | wallet history (falls back to Blockscout) |
CDP_API_KEY_ID / CDP_API_KEY_SECRET |
for 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 MCP questions
How do I add UXUS Agent Services MCP to Claude Code?
Run claude mcp add --transport http cryptorisk-api https://uxus.finance/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add UXUS Agent Services MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Which blockchains are supported for address lookups?
The service provides address lookups for Ethereum, Base, and XRPL with automatic chain detection.