io.github.vjshaw/nulucre-wallet-reputation·Crypto

nulucre-wallet-reputation

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

Stars
0
Version
1.0.0
License
—
Review
Passed
Language
JavaScript
Last commit
1h ago
Forks
0
Open issues
0
Registry update
Oct 17, 2026
ai-agentsbase-networkdefidefi-ai-agentfact-verificationmicropaymentsreputation-oracleusdcx402-agentx402-payment

Connect

remote
Terminal
$claude mcp add --transport http nulucre-wallet-reputation https://agents.nulucre.com/mcp

Headers

Nothing to configure — it works as is.

Security review

Review passed

Reviewed 12m ago.

tools
4 tools scanned
metadata
scanned

No findings.

Tools

4
  • nulucre_get_stellar_wallet_score

    Get a 0-100 trust score for a Stellar wallet address (G...) from Nulucre, a live Stellar-native wallet reputation oracle. The score is computed from 8 signals pulled directly from the Stellar Horizon API and Stellar Expert — account age, transaction volume, asset diversity, SDEX DEX participation, network trust, claimable balance activity, Soroban contract interactions, and liquidity pool participation, plus a spam detection penalty. No EVM data is used. Every score includes a real-time sanctions screening result against the OFAC SDN, OFAC Non-SDN, EU Financial Sanctions, and UN Security Council Sanctions lists. A wallet matching any of these lists automatically receives a score of 0 and status BLACKLISTED. Use this tool to assess counterparty risk before an agent interacts with or pays a Stellar wallet — for example before executing a payment, approving a swap counterparty, or evaluating a new account. Args: - g_address (string): Stellar wallet address starting with 'G' (56 char

  • nulucre_get_evm_wallet_score

    Get a 0-100 trust score for an EVM wallet address (0x...) from Nulucre, a multi-chain wallet reputation oracle covering 81+ chains. The score is computed from on-chain data including wallet age, transaction volume, DeFi activity, and multi-chain presence, pulled from Etherscan, Moralis, Alchemy, and Ankr. Use this tool to assess counterparty risk before an agent interacts with or pays an EVM wallet on Ethereum, Base, Polygon, Arbitrum, Optimism, or any of the 81+ supported chains. Args: - wallet (string): EVM wallet address starting with '0x' (42 characters) - signed (boolean): If true, request an ECDSA-P256 signed score for independent verification via Nulucre's public JWKS endpoint (default: false) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: For JSON format: Structured data with schema: { "wallet": string, "score": number, // 0-100 "status": string, // TRUSTED | VERIFIED | CAUTION | RISKY | B

  • nulucre_get_xrpl_wallet_score

    Get a 0-100 trust score for an XRPL wallet address (r...) from Nulucre. Scored using 7 XRPL Ledger signals: account age, transaction volume, trustline diversity, DEX participation, network trust, payment activity, and spam detection. Includes real-time OFAC/UN/EU sanctions screening. Use before paying or interacting with any XRPL wallet.

  • nulucre_check_service_status

    Check whether the live Nulucre reputation oracle service is online. This is a free endpoint that requires no payment. Use this tool to verify Nulucre is reachable before relying on it for wallet scoring decisions, or for general uptime monitoring. Args: none Returns: Structured data with schema: { "status": string, // "online" if the service is reachable "service": string // service name } Examples: - Use when: "Is Nulucre up?" -> no params needed - Use when: checking service availability before a batch of scoring calls Error Handling: - Returns "Error: ..." with details if the service is unreachable

Nulucre Agents — The On-Chain Credit Score for AI Agents

Two autonomous AI agents accepting USDC micropayments via x402 on Base mainnet and Stellar pubnet. No API keys, no accounts, no subscriptions — pure agent-to-agent commerce.

Agents

🔵 Reputation Oracle

The credit score for crypto wallets. Returns a 0-100 trust score across 81+ chains with ECDSA cryptographic proof.

Scoring Breakdown

ComponentMax ScoreSource
Wallet Age30Etherscan V2
TX Volume40Etherscan V2
DeFi Activity20Moralis / DeBank
Base Activity10Basescan via Etherscan V2
Multi-Chain EVM10Alchemy (Polygon, Arbitrum, Optimism)
Ankr Coverage10Ankr (81+ chains)
Total100+Multi-source

Pricing & Networks

TierEndpointPriceNetworks
StandardGET /reputation/{wallet}$0.003 USDCBase Mainnet + Stellar Pubnet
SignedGET /reputation/signed/{wallet}$0.01 USDCBase Mainnet + Stellar Pubnet
Stellar ScoreGET /reputation/stellar/{gAddress}$0.003 USDCStellar Pubnet
Stellar SignedGET /reputation/stellar/signed/{gAddress}$0.01 USDCStellar Pubnet
VerificationPOST /verify$0.01 USDCBase Mainnet + Stellar Pubnet
TVL LookupGET /tvl/{protocol}FREE-
HealthGET /healthFREE-

Cryptographic Verification

Signed scores are independently verifiable by any agent:

Status Labels:

ScoreStatus
80–100TRUSTED
60–79VERIFIED
40–59CAUTION
20–39RISKY
0–19BLACKLISTED

Standard Response:

{
  "wallet": "0x123...abc",
  "score": 97,
  "status": "TRUSTED",
  "breakdown": {
    "walletAge": { "score": 30, "raw": "3827 days" },
    "txVolume": { "score": 40, "raw": "10000 txs" },
    "defiActivity": { "score": 8, "raw": "4 protocols" },
    "multiChain": { "score": 9, "raw": "3 EVM chains" },
    "ankrCoverage": { "score": 10, "raw": "16 chains with assets" }
  },
  "chains": ["ethereum", "base", "polygon", "arbitrum", "optimism", "ankr-81-chains"],
  "timestamp": "2026-03-24T00:00:00.000Z"
}

Signed Response:

{
  "wallet": "0x123...abc",
  "score": 97,
  "status": "TRUSTED",
  "proof": {
    "signature": "MEQCIFruX2vD...",
    "algorithm": "ECDSA-P256",
    "signedBy": "nulucre.com",
    "verifyAt": "https://nulucre.com/.well-known/jwks.json"
  }
}

🟡 Fact Verification Agent — $0.01 USDC per report

Verifies DeFi protocol TVL claims against DeFi Llama on-chain data. Returns ACCURATE, MISLEADING, or FALSE.

Endpoint: POST https://nulucre.com/verify

Request Body:

{
  "claim": "Aave has $12B TVL",
  "protocol": "aave"
}

Example Response:

{
  "verdict": "ACCURATE",
  "claimedTVL": 12000000000,
  "actualTVL": 11840000000,
  "discrepancyPercent": -1.3,
  "dataSource": "DeFi Llama",
  "timestamp": "2026-03-24T00:00:00.000Z"
}

Verdicts:

  • ACCURATE (< 5% difference)
  • MOSTLY_ACCURATE (5–10%)
  • INACCURATE (10–25%)
  • MISLEADING (25–50%)
  • FALSE (> 50%)

🆓 Free Endpoints

Health check: GET https://nulucre.com/health

Raw TVL lookup: GET https://nulucre.com/tvl/{protocol}


How x402 Payment Works

  1. Agent calls your endpoint
  2. Server returns 402 Payment Required with payment details for Base or Stellar
  3. Agent sends USDC on Base mainnet or Stellar pubnet
  4. Agent includes payment proof in next request header
  5. Server verifies and returns data

No accounts. No API keys. Fully autonomous agent-to-agent payments.

Payment Details

NetworkTokenAddress
Base MainnetUSDC (ERC-20)0xd97C122cB81894213C67Bcc774448955d09915bC
Stellar PubnetUSDC (SEP-41)GCRUBFDANV52JP3URUJ7EZGPZKFEESBTW7T3FV2SJXZZGB6HDNRBWV24

Stack

  • Node.js + Express
  • x402 payment protocol
  • Etherscan V2 (wallet age + tx volume)
  • Moralis / DeBank (DeFi activity)
  • Alchemy (Polygon, Arbitrum, Optimism)
  • Ankr (81+ chains)
  • DeFi Llama (TVL verification)
  • ECDSA-P256 cryptographic signing
  • OpenZeppelin Stellar facilitator
  • PM2 + Nginx on Ubuntu VPS

Agent Discovery

https://nulucre.com/.well-known/SKILL.md
https://nulucre.com/.well-known/x402.json
https://nulucre.com/.well-known/agent.json
https://nulucre.com/.well-known/jwks.json
https://nulucre.com/openapi.json

🆓 Try It Free — No Payment Needed

Test the API instantly with no x402 setup required:

curl https://nulucre.com/reputation/0x000000000000000000000000000000000000TEST

Returns a sample wallet score response immediately. For real wallet scoring, use any EVM address — $0.001 USDC via x402.

Quick Start

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

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

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

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

# Stellar native wallet reputation query (requires x402 payment)
curl https://nulucre.com/reputation/stellar/GYourStellarAddress

# Stellar signed reputation query with ECDSA proof
curl https://nulucre.com/reputation/stellar/signed/GYourStellarAddress

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

Copy and paste this replacing your existing Quick Start section → commit! 👊

Links

License

MIT

From the server's repository — third-party content, read it before running anything it suggests.

More in Crypto

Listing from the official MCP Registry · repository facts from GitHub, 15m ago.