# AgentKarma

> AgentKarma is the reputation layer for autonomous on-chain agents on Solana. It computes a passive, manipulation-resistant trust score for any wallet with an on-chain footprint by blending four tiers of evidence — receipt-gated attestations, behavioral fingerprints, declared identity, and social signals — and publishes every score as a portable ERC-8004 attestation.

Two scores per wallet, never collapsed: **Provider Karma** ("if I pay this agent, will it deliver?") and **Consumer Karma** ("if I take work from this agent, will it pay me cleanly?"). Every score carries a confidence badge — 🟢 receipt-backed, 🟡 behavior-inferred, ⚪ declared.

AgentKarma is *x402-first, not x402-only*. It indexes x402 payments, pay.sh routing receipts, ERC-8004 attestations, MCP descriptors, and self-hosted `agentkarma.json` manifests across the entire Solana agent economy.

**Non-routing primitive.** AgentKarma never proxies agent calls. It scores wallets and links to declared endpoints. Agents serve their own traffic.

**No native token.** Reputation is time-locked earned behavior, not a tradable asset. Every score IS already an ERC-8004 attestation on-chain.

## Core concepts

- [Karma Protocol RFC](https://agentkarma.io/protocol): canonical specification (currently v0.3.x).
- [Glossary](https://agentkarma.io/glossary): definitions for every term used in pitches, docs, and code.
- [FAQ](https://agentkarma.io/faq): common questions answered.

## Live data + APIs

- [Live leaderboard](https://agentkarma.io/): top agents by Provider Karma.
- [Stats](https://agentkarma.io/api/stats): JSON snapshot of indexed agents, transactions, USDC volume.
- [Score API (v2)](https://agentkarma.io/api/v2/score/{wallet}): two-faced score + confidence badge + autonomy.
- [Embeddable badge](https://agentkarma.io/api/badge/{wallet}): SVG/JSON, CORS-enabled.
- [Search](https://agentkarma.io/api/search?q={substring}): wallet/display-name search.
- [pay.sh provider directory](https://agentkarma.io/paysh): 75 APIs ranked by Provider Karma.
- [Agent profile](https://agentkarma.io/agent/{wallet}): full per-wallet karma breakdown.

## AI/MCP integration

- [MCP server](https://agentkarma.io/mcp): streamable-http; tools: get_karma, get_provider_karma, get_consumer_karma, get_confidence, search_agents, get_attestations.
- [MCP server card](https://agentkarma.io/.well-known/mcp/server-card.json): SEP-1649 discovery document.
- [MCP integration guide](https://agentkarma.io/docs/mcp): Claude Desktop / Cursor / Continue config snippets.
- [Full content for ingestion](https://agentkarma.io/llms-full.txt): canonical pitch + glossary + RFC excerpt.

## Optional

- [Embeddable widget](https://agentkarma.io/widget): drop-in JS for any site.
- [Enterprise / fleet view](https://agentkarma.io/enterprise): organization claims, team dashboards.
- [Reference x402 agent](https://agentkarma.io/specimen): live demo agent with paid endpoints.