get_agent_reputation
Retrieve reputation scores and detailed metrics for AI agents, including tier breakdowns, endorsements, uptime, and performance history to assess trustworthiness.
Instructions
Get an agent's reputation score (0-100) with full breakdown by tier, endorsements, uptime, age, and wishes granted.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | The agent ID |
Implementation Reference
- src/reputation.js:222-275 (handler)The core logic for computing an agent's reputation score, including breakdown by tier, endorsements, uptime, and wishes.
function computeReputation(agentId) { const db = getDb(); const agent = db.prepare('SELECT * FROM agents WHERE id = ?').get(agentId); if (!agent) return null; // Get stamp tier let stampTier = null; if (agent.stamp_id) { const stamp = db.prepare('SELECT tier FROM stamps WHERE id = ? AND revoked = 0').get(agent.stamp_id); if (stamp) stampTier = stamp.tier; } // Count wishes granted by this agent's wallet const wishesGranted = db.prepare( "SELECT COUNT(*) as count FROM wishes WHERE granted_by = ?" ).get(agent.wallet_address)?.count || 0; // Calculate each factor const tierScore = TIER_SCORES[stampTier] || 0; const endorsementScore = Math.min((agent.endorsement_count || 0) * 5, 30); const uptimePercent = computeUptimePercent(agent); const uptimeScore = uptimePercent * 0.20; const wishScore = Math.min(wishesGranted * 2, 5); const walletVerifiedBonus = agent.wallet_verified ? WALLET_VERIFIED_BONUS : 0; // Apply trust score decay based on heartbeat recency const decayInfo = computeDecayInfo(agent); const decayedUptimeScore = uptimeScore * decayInfo.decay_multiplier; // Compute cold-start momentum (replaces age_score) const momentum = computeMomentum(agent, db); const rawScore = tierScore + endorsementScore + decayedUptimeScore + momentum.effective + wishScore + walletVerifiedBonus - decayInfo.penalty; const score = clamp(0, 100, Math.round(rawScore)); return { score, label: getLabel(score), breakdown: { tier: Math.round(tierScore), endorsements: Math.round(endorsementScore), uptime: Math.round(decayedUptimeScore * 10) / 10, momentum: Math.round(momentum.effective * 10) / 10, wishes: Math.round(wishScore), wallet_verified: walletVerifiedBonus, decay_info: decayInfo, }, factors: { stamp_tier: stampTier || 'none', endorsement_count: agent.endorsement_count || 0, - src/mcp-server.js:178-194 (registration)Registration of the get_agent_reputation MCP tool which calls computeReputation.
// --- Tool: get_agent_reputation --- server.tool( 'get_agent_reputation', 'Get an agent\'s reputation score (0-100) with full breakdown by tier, endorsements, uptime, age, and wishes granted.', { agent_id: z.string().describe('The agent ID'), }, async ({ agent_id }) => { const reputation = computeReputation(agent_id); if (!reputation) { return { content: [{ type: 'text', text: JSON.stringify({ error: 'Agent not found' }) }] }; } return { content: [{ type: 'text', text: JSON.stringify({ agent_id, ...reputation }, null, 2) }], }; } );