io.github.vjshaw/nulucre-wallet-reputation

Official registry Finance and payments

Wallet trust scores for AI agents. Stellar, XRPL, EVM 81+ chains. OFAC sanctions. x402 payments.

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 nulucre-wallet-reputation 'https://agents.nulucre.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "nulucre-wallet-reputation": {
            "type": "http",
            "url": "https://agents.nulucre.com/mcp"
        }
    }
}

Documentation

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

Contents
  1. Nulucre Agents — Wallet Reputation Oracle for AI Agents
  2. Endpoints
  3. Payment Networks
  4. Score Bands
  5. Standard Response
  6. How x402 Payment Works
  7. Cryptographic Verification
  8. Agent Discovery
  9. Quick Start
  10. Stack
  11. Links

Nulucre Agents — Wallet Reputation Oracle for AI Agents

Real-time wallet trust scores across 4 chains, paid via x402 micropayments. No API keys, no accounts, no subscriptions — pure agent-to-agent commerce.

Base URL: https://agents.nulucre.com
Methodology: https://agents.nulucre.com/methodology
MCP Server: https://agents.nulucre.com/mcp


Endpoints

EndpointPriceDescription
GET /reputation/{wallet}$0.001 USDCEVM wallet score (81+ chains)
GET /reputation/signed/{wallet}$0.01 USDCEVM score with ECDSA proof
GET /reputation/stellar/{G-address}$0.001 USDCStellar wallet score
GET /reputation/stellar/signed/{G-address}$0.01 USDCStellar score with ECDSA proof
GET /reputation/xrpl/{r-address}$0.001 USDCXRPL wallet score
GET /reputation/solana/{address}$0.001 USDCSolana wallet score
POST /verify$0.01 USDCDeFi TVL fact verification
GET /tvl/{protocol}FREERaw TVL lookup
GET /healthFREEHealth check
GET /methodologyFREEScoring methodology

Payment Networks

NetworkTokenPay To
Base MainnetUSDC (ERC-20)0xd97C122cB81894213C67Bcc774448955d09915bC
Stellar PubnetUSDC (SEP-41)GCRUBFDANV52JP3URUJ7EZGPZKFEESBTW7T3FV2SJXZZGB6HDNRBWV24
Solana MainnetUSDC (SPL)GCRUBFDANv52JP3URUJ7EZGPZKFEESBTW7T3FV2SJXZZGB6HDNRBWV24

Score Bands

ScoreStatusMeaning
80–100TRUSTEDLong history, high activity, broad multi-chain footprint
60–79VERIFIEDEstablished wallet with meaningful on-chain history
40–59CAUTIONLimited history or signals
20–39RISKYVery new, inactive, or abnormal patterns
0–19BLACKLISTEDSanctioned or near-zero activity
—INSUFFICIENT_DATAFewer than 5 txs (EVM/Solana) or 3 txs (Stellar/XRPL) — not a risk verdict

Full methodology: https://agents.nulucre.com/methodology


Standard Response

{
  "wallet": "0x123...abc",
  "score": 74,
  "status": "VERIFIED",
  "network": "evm",
  "breakdown": {
    "walletAge": { "score": 28, "raw": "3400 days" },
    "txVolume": { "score": 35, "raw": "2100 txs" },
    "defiActivity": { "score": 6, "raw": "3 protocols" },
    "multiChain": { "score": 5, "raw": "2 EVM chains" }
  },
  "timestamp": "2026-10-20T00:00:00.000Z"
}

Thin-file response:

{
  "wallet": "0x123...abc",
  "score": null,
  "status": "INSUFFICIENT_DATA",
  "message": "Too few transactions to score reliably",
  "timestamp": "2026-10-20T00:00:00.000Z"
}

How x402 Payment Works

  1. Agent calls endpoint
  2. Server returns 402 Payment Required with payment details (Base, Stellar, or Solana)
  3. Agent sends USDC on chosen network
  4. Agent includes payment proof in next request header
  5. Server verifies and returns score

No accounts. No API keys. Fully autonomous.


Cryptographic Verification

Signed endpoints return an ECDSA-P256 signature verifiable against the Nulucre public key.

  • JWKS: https://nulucre.com/.well-known/jwks.json
  • Algorithm: ECDSA-P256 / SHA-256 / IEEE P1363

Agent Discovery

https://agents.nulucre.com/reputation/ https://nulucre.com/.well-known/agent.json https://nulucre.com/.well-known/x402.json https://nulucre.com/.well-known/jwks.json https://nulucre.com/openapi.json


Quick Start

# Free health check
curl https://agents.nulucre.com/health

# Free TVL lookup
curl https://agents.nulucre.com/tvl/aave

# EVM wallet score (requires x402 payment)
curl https://agents.nulucre.com/reputation/0xYourWalletAddress

# EVM signed score with ECDSA proof
curl https://agents.nulucre.com/reputation/signed/0xYourWalletAddress

# Stellar wallet score
curl https://agents.nulucre.com/reputation/stellar/GYourStellarAddress

# XRPL wallet score
curl https://agents.nulucre.com/reputation/xrpl/rYourXRPLAddress

# Solana wallet score
curl https://agents.nulucre.com/reputation/solana/YourSolanaAddress

# Fact verification
curl -X POST https://agents.nulucre.com/verify \
  -H "Content-Type: application/json" \
  -d '{"claim": "Uniswap has $5B TVL", "protocol": "uniswap"}'

Stack

  • Node.js + Express + PM2
  • x402 payment protocol (Base, Stellar, Solana)
  • Etherscan V2, Alchemy, Ankr, DeBank/Moralis (EVM)
  • Stellar Horizon + StellarExpert (Stellar)
  • xrplcluster.com (XRPL)
  • Solana Mainnet RPC (Solana)
  • ECDSA-P256 cryptographic signing
  • Nginx reverse proxy on Ubuntu VPS


MIT License — © 2026 Nulucre Inc.

Frequently asked questions

What is io.github.vjshaw/nulucre-wallet-reputation?

Wallet trust scores for AI agents. Stellar, XRPL, EVM 81+ chains. OFAC sanctions. x402 payments.

How do I install io.github.vjshaw/nulucre-wallet-reputation?

It runs as a remote server. In Claude Code: claude mcp add --transport http nulucre-wallet-reputation 'https://agents.nulucre.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.vjshaw/nulucre-wallet-reputation 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 io.github.vjshaw/nulucre-wallet-reputation open source?

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

Who maintains io.github.vjshaw/nulucre-wallet-reputation?

It is published by vjshaw. 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.