djd-agent-score-mcp

Get the basic reputation score for an AI agent wallet on Base.

Returns a numeric score (0-1000), tier (e.g. "Trusted", "Neutral", "Risky"), confidence level, recommendation text, model version, and freshness info.

This is a FREE endpoint — no x402 payment required.

Args:

• wallet (string): Ethereum wallet address (0x + 40 hex chars)

Returns: { wallet, score, tier, confidence, recommendation, modelVersion, lastUpdated, computedAt, scoreFreshness }

Examples:

• "What's the reputation of 0xABC...?" -> score_basic with that wallet

• "Is this agent wallet trustworthy?" -> score_basic to get tier/recommendation

Get the full reputation score with dimension breakdown for an AI agent wallet.

Returns everything from basic score PLUS per-dimension scores and rich data:

• dimensions.reliability: { score, data: { txCount, nonce, successRate, ... } }

• dimensions.viability: { score, data: { usdcBalance, ethBalance, inflows30d, ... } }

• dimensions.identity: { score, data: { hasBasename, insumerVerified, walletAgeDays, ... } }

• dimensions.capability: { score, data: { activeX402Services, totalRevenue, ... } }

• sybilFlag, gamingIndicators, dataAvailability

• improvementPath (actionable steps to raise the score)

• scoreHistory (historical score trend)

The identity dimension includes "insumerVerified" (v2.3+) which indicates whether the wallet holds qualifying tokens verified via the Insumer attestation API, contributing up to 15 points toward the identity score.

PAID endpoint — requires x402 payment ($0.10 USD). If your agent framework supports x402, the 402 response will contain payment instructions. Complete the payment and retry the request.

Args:

• wallet (string): Ethereum wallet address (0x + 40 hex chars)

Returns: { wallet, score, tier, confidence, recommendation, modelVersion, lastUpdated, computedAt, scoreFreshness, sybilFlag, gamingIndicators, dimensions, dataAvailability, improvementPath, scoreHistory }

Force a re-score of an AI agent wallet using the latest on-chain data.

Use this when you suspect the cached score is stale or after known on-chain activity that should change the score.

PAID endpoint — requires x402 payment ($0.25 USD).

Args:

• wallet (string): Ethereum wallet address (0x + 40 hex chars)

Returns: { score, tier, confidence, recommendation, modelVersion, refreshedAt }

Submit a fraud report for a wallet with supporting transaction hashes and evidence.

PAID endpoint — requires x402 payment ($0.02 USD).

Args:

• wallet (string): Ethereum wallet address of the suspected fraudster

• tx_hashes (string[]): Array of transaction hashes as evidence

• evidence (string): Text description of the fraudulent behavior

Returns: { success, reportId, message }

Check if a wallet has any fraud reports filed against it.

PAID endpoint — requires x402 payment ($0.05 USD).

Args:

• wallet (string): Ethereum wallet address to check

Returns: { wallet, reported, reportCount, reports[] }

Get the embeddable SVG badge URL for a wallet's reputation score.

Returns the badge endpoint URL and the raw SVG content. The URL can be embedded in markdown, HTML, or any context that supports images.

This is a FREE endpoint.

Args:

• wallet (string): Ethereum wallet address

Returns: { badgeUrl, svg }

Get the leaderboard of top-scored AI agent wallets.

Returns a ranked list of wallets with their scores and tiers.

This is a FREE endpoint.

Args:

• limit (number, optional): Maximum number of entries to return (1-100)

Returns: Array of { wallet, score, tier }

Register an AI agent wallet with metadata (name, description, optional GitHub URL).

This is a FREE endpoint.

Args:

• wallet (string): Ethereum wallet address to register

• name (string): Display name for the agent

• description (string): What this agent does

• github_url (string, optional): GitHub repository URL

Returns: { success, message }

Check the DJD Agent Score API system status.

This is a FREE endpoint.

Returns: { status, version, uptime }