# iAgentRef

> Agent Discovery & Capability Search

iAgentRef indexes every ERC-8004 agent across all supported chains and provides semantic capability search for the agent economy.

## What it does

- **Cross-chain indexing**: Every ERC-8004 Identity Registry entry across Ethereum, Base, Avalanche, BNB Chain, plus every published agent-card.json endpoint, deduplicated and normalized into a single index.
- **Semantic capability search**: Query 'find an agent that does onchain research' and iAgentRef returns ranked matches by skill tag, agent-card description, and observed behavior.
- **Ranking signals**: Inputs include iAgentFi ratings, ERC-8004 Reputation Registry feedback, and on-chain activity data.
- **Real-time freshness**: Registry polling plus on-chain event subscription means results reflect registrations within minutes.

## Part of the iJarvis Agent Stack

Four products shipping in 2026. Eleven more on a three-year roadmap. One entity (iJarvis LLC). One SDK (`pip install iagent-stack`).

**Shipping 2026 (Cluster 1):** iAgentFi (trust & ratings), iAgentRef (discovery), iAgentLog (observability), iAgentPay (x402 treasury — anchor product), iJarvis Compute (boutique inference on owned hardware).

**Roadmap 2027 (Cluster 2):** iAgentSafe (runtime guardrails), iAgentMemory (portable memory), iAgentHub (productized bundle gateway), iAgentEdge (on-prem appliance pilots), iAgentFarm (agent hosting).

**Roadmap 2028 (Cluster 3):** iAgentSim (adversarial simulation), iAgentID (verifiable credentials), iAgentMarket (capability marketplace), iAgentFoundry (fine-tuning).

**Parked:** iAgentLaw (pending law-firm anchor partnership).

**Internal infrastructure:** iAgentGrid (private compute fabric; not a public product).

Cluster 1 endpoints serve live traffic in 2026. Roadmap product endpoints return 503 or `ProductNotAvailableError` until their cluster launches. Check each site's `.well-known/agent-card.json` `status` and `productAvailability.publicEndpointActive` fields for honest availability.

## Standards and protocols

ERC-8004 v1 (agent identity + reputation + validation registries)
x402 V2 (HTTP-native payments, multi-chain)
A2A 0.3.0 (agent-to-agent communication)
MCP 2025-06-18 (Model Context Protocol)
OASF 0.8 (Open Agent Schema Framework)
AP2 v1 (Google Agent Payments Protocol)
W3C Verifiable Credentials (via iAgentID)


## Endpoints

- **Agent card (ERC-8004):** https://iagentref.com/.well-known/agent-card.json
- **MCP manifest:** https://iagentref.com/.well-known/mcp.json
- **x402 discovery:** https://iagentref.com/.well-known/x402.json
- **DID document:** https://iagentref.com/.well-known/did.json
- **OpenAPI 3.1:** https://iagentref.com/.well-known/openapi.yaml
- **Public API:** https://api.iagentref.com/v1/
- **MCP server:** https://mcp.iagentref.com/

## Contact

hello@iagentref.com · iJarvis LLC · https://ijarvis.ai