Indexing ERC-8004 + x402 protocols live

Know which AI agents you can trust.

Before an AI agent touches your funds, know if it can be trusted. One API call to score any wallet, built on real on-chain data from ERC-8004 and x402.

Documentation →

Indexes on-chain data from

ERC-8004 Identity
ERC-8004 Reputation
x402 Payments
Base L2
index.tscurl
// Get trust score + tier + role
const karma = new AgentKarma()

const { trust_score, tier, role } = await karma.getScore('0xABC...DEF')

// Gate a payment on trust
if (await karma.isHighTrust(seller)) {
  await agent.pay(seller, amount)
}

Live data

Built for scale.

Wallets indexed

26,051+

Across Ethereum and Base

Live

Transactions

234,478

x402 payments and ERC-8004 mints

Feedback records

77,516

On-chain reputation from ERC-8004

Scoring model

7

Weighted signals: loyalty, activity, diversity, feedback, volume, recency, age

License

Open Source

MIT licensed. Self-host or use the public API free.

Integrations

API First

14 endpoints · 7 MCP tools · 11 SDK methods

Capabilities

Everything you need to assess agent trust.

SDK, API, MCP server, and dashboard. Open source under MIT.

Trust Scoring

7-signal weighted model: loyalty (30%), activity (18%), diversity (16%), feedback (15%), volume (10%), recency (6%), age (5%). Score 0–100 with ERC-8004 registration bonus.

REST API

13 endpoints including /score, /wallet, /wallets, /leaderboard, /stats, /api-keys, batch lookups, and OpenAI function schema. Paginated, filterable, CORS enabled.

TypeScript SDK

Zero-dependency npm package. 12 methods including getScore(), isHighTrust(), batchScores(), listWallets(), and more. One-line install: npm install agentkarma.

MCP Server

6 tools: lookup_wallet, get_trust_score, get_wallet_trust_signals, batch_trust_scores, list_wallets, agentkarma_stats. Stdio transport for Claude, Cursor, or any MCP agent.

Public Dashboard

Search any wallet address. View trust score breakdowns, 7-signal bars, role, chain, and history. Live leaderboard of top-scored agents.

Sybil Resistance

Loyalty signal caps wallets with suspiciously concentrated patterns (>20 txns to <3 counterparties). Based on Arbitrum sybil detection research.

Quick Start

From install to trust check in under a minute.

1

Install the SDK

Zero dependencies. Works in Node, Deno, Bun, and browsers. Or call the REST API directly with no install needed.

$ npm install agentkarma
2

Gate payments on trust

Returns true if trust_score ≥ 80. One line to verify any agent before transacting.

import { AgentKarma } from 'agentkarma'

const karma = new AgentKarma()

if (await karma.isHighTrust(seller)) {
  await agent.pay(seller, amount)
}
3

Or add the MCP server

Add to Claude Code, Cursor, or any MCP-compatible agent. 6 tools available including batch scoring and leaderboard.

{
  "mcpServers": {
    "agentkarma": {
      "command": "npx",
      "args": ["-y", "agentkarma", "mcp"]
    }
  }
}

Use cases

For every type of agent.

Whether you're building buyer agents, seller agents, or managing a fleet.

index.ts
const karma = new AgentKarma()

if (await karma.isHighTrust(seller)) {
  await agent.pay(seller, amount)
}

Buyer-Agent Developers

Gate payments on trust.

Before your AI agent sends USDC to an unknown wallet, check the trust score. isHighTrust() returns a boolean. One line to block scam agents.

index.ts
const { trust_score, tier, role } =
  await karma.getScore(myWallet)

// trust_score: 84, tier: "HIGH"

Seller-Agent Developers

Build verifiable reputation.

Every honest transaction improves your score. Loyalty, activity, and diversity signals reward consistent behavior. ERC-8004 registration adds a +5 bonus.

index.ts
const board = await karma.getLeaderboard({
  limit: 50, source: 'x402'
})
// [{ rank: 1, trust_score: 84 }]

Fleet Managers

Monitor your entire fleet.

Pull the leaderboard or query individual agents. Filter by source (ERC-8004, x402, or both). Paginate through all indexed wallets.

Frequently
asked questions

Everything you need to know about AgentKarma's scoring, data sources, and integrations.

Two on-chain protocols across Ethereum and Base. ERC-8004 provides agent identity (IdentityRegistry NFTs) and reputation data (ReputationRegistry feedback). x402 captures Coinbase's HTTP payment protocol transactions between AI agents, detected via AuthorizationUsed events on USDC. Arbitrum support is coming soon.
Seven weighted signals: Loyalty (30%) measures repeat business with Sybil resistance. Activity (18%) uses log scale capping at 100 txns. Diversity (16%) counts unique counterparties. Feedback (15%) is confidence-weighted. Volume (10%) scores average USDC deal size. Recency (6%) decays to 0 at 90 days. Age (5%) caps at 180 days. ERC-8004 registered agents get a +5 bonus.
HIGH (80–100): Highly trusted, safe to transact with. MEDIUM (50–79): Moderate reputation, some track record. LOW (20–49): Limited history, proceed with caution. MINIMAL (0–19): New or inactive wallet.
Yes. The API, SDK, MCP server, dashboard, and all source code are free and open source under the MIT license. No API key required to get started. Free keys available for tracked usage at 1,000 requests/day.
Three options. npm install agentkarma for the TypeScript SDK (12 methods, zero dependencies). Call the REST API directly at /score/:address. Or use the MCP server with 6 tools for Claude, Cursor, or any MCP-compatible agent framework.
Ethereum mainnet and Base L2 are fully indexed. ERC-8004 identity and reputation data is indexed on both chains. x402 payment transactions are indexed on Base. Arbitrum support is on the roadmap.
Scores are recomputed after each indexer run. The indexer scans the last 7 days of blocks on each chain. Scores reflect on-chain state at the time of the last rescore. You can check when a wallet was last seen via the /wallet/:address endpoint.
Yes. POST /feedback with the wallet address, a score (0–100), and an optional comment. Feedback is stored and weighted into the wallet's trust score on the next rescore. The API is open with no API key required to submit.
The MCP (Model Context Protocol) server exposes 6 tools: get_trust_score, lookup_wallet, get_wallet_trust_signals, batch_trust_scores, list_wallets, agentkarma_stats. All tools run over stdio. Add it to any MCP-compatible client like Claude Desktop or Cursor by pointing to npx agentkarma mcp in your config.
Yes. The full codebase is open source on GitHub under the MIT license at github.com/rushikeshmore/agent-karma.

Get started

Start verifying agents.

One API call. Zero dependencies. MIT licensed. No API key required to get started.

install · REST API · MCP
$ npm install agentkarma

# or query the API directly
GET /score/0x... { trust_score, tier, score_breakdown, role }