Open App

agents_trust_score_list

>-

agents_trust_score_list

Returns a paginated list of all ERC-8004 registered AI agents with their trust scores. Use this for discovery, ranking, and filtering agents before interacting with them or passing an agent_id to agents_trust_score_single.

MCP Endpoint: https://prediction.mcp.chainaware.ai/sse

Typical Workflow

agents_trust_score_list → get agent_id + chain_id → agents_trust_score_single → full trust profile

Input Schema

Field Type Required Description
page string Yes Page number for pagination (1-indexed)
limit string Yes Number of results per page
sort_by string No Field to sort by: registered_at, trust_score, or reputation_score
sort_order string No asc or desc (default: desc). Required if sort_by is set
registered_after string No ISO-8601 datetime - filter to agents registered after this date

Output Schema

{
  "total": 0,
  "page": 1,
  "limit": 10,
  "results": [
    {
      "chain_id": 1,
      "agent_id": 0,
      "owner_address": "string",
      "agent_wallet": "string",
      "agent_uri": "string",
      "meta_name": "string",
      "registered_at": "ISO-8601",
      "reputation_score": 0,
      "trust_score": 0,
      "trust_tier": "string"
    }
  ]
}

Key Fields

Field Description
agent_id Unique agent identifier - required for agents_trust_score_single
chain_id Chain where the agent is registered - required for agents_trust_score_single
agent_wallet The agent's operational wallet address
owner_address The human or entity who registered and controls the agent
trust_score 0-1000 composite trust score derived from on-chain behavioral history
trust_tier Human-readable tier label (see Tier Interpretation below)

Trust Tier Interpretation

Score Range Trust Tier Meaning
800-1000 Elite Exceptionally strong on-chain history - high confidence to transact
600-799 High Strong track record - suitable for most agentic commerce use cases
400-599 Moderate Some history present - proceed with transaction limits
200-399 Low Thin or mixed history - enhanced scrutiny recommended
1-199 Very Low Insufficient or negative history - avoid high-value interactions
0 Fraud / New Flagged as fraudulent or no verifiable on-chain history

Code Examples

Node.js

const list = await client.callTool({
  name: "agents_trust_score_list",
  arguments: {
    page: "1",
    limit: "10",
    sort_by: "trust_score",
    sort_order: "desc"
  }
});

console.log(`Total agents: ${list.total}`);
list.results.forEach(agent => {
  console.log(`${agent.meta_name} - Trust: ${agent.trust_score} (${agent.trust_tier})`);
});

Python

list_result = await session.call_tool("agents_trust_score_list", {
    "page": "1",
    "limit": "20",
    "sort_by": "trust_score",
    "sort_order": "desc",
    "registered_after": "2025-01-01T00:00:00Z"
})

print(f"Total: {list_result['total']}")
for agent in list_result["results"]:
    print(f"{agent['meta_name']} - {agent['trust_score']} ({agent['trust_tier']})")

Example Agent Prompts

List all ERC-8004 AI agents sorted by trust score
Which registered agents have the highest trust score?
Show me all agents registered after 2025-01-01
List the top 10 most trusted AI agents
Which agents have a trust score above 800?

Common Chain IDs

chain_id Chain
1 Ethereum
56 BNB Chain
8453 Base
137 Polygon
42161 Arbitrum

Use Cases

  • AI agent marketplaces - rank and surface agents by trust score
  • Agentic commerce platforms - discover and whitelist trusted agents before they transact on behalf of users
  • DeFi protocols - build an allowlist of high-trust agents for privileged operations
  • Compliance workflows - audit which agents a protocol has interacted with

Error Codes

Code Meaning
400 Malformed page, limit, or sort_by
500 Temporary backend failure - retry after a short delay

Further Reading

See also: agents_trust_score_single | Prediction MCP Overview | Setup Guide