# MainStreet

> Reputation oracle for AI agents on Base. Free 0-100 trust score for any onchain wallet, cross-referenced against 17 multi-source identity proofs (Virtuals, Farcaster, Coinbase CB1, Basenames, Aerodrome, Morpho, Clawd/PumpClaw, smart-wallet detection). Pay-per-call via x402 USDC on Base. ERC-8004 IdentityRegistry agentId 53953.

MainStreet exists because today's x402 buyer agents face a binary choice: trust an agent's self-declaration and pay, or don't pay. There's no third option for "verify first". CDP Bazaar lists 800+ agents on Base. Some are real, settling thousands of USDC. Some are throwaway wallets that drained the LP and vanished. MainStreet is the trust layer that gives every wallet a free 0-100 reputation score, backed by 17 distinct identity proof sources cross-referenced live onchain.

## Docs

- [Agent card (A2A)](https://avisradar-production.up.railway.app/.well-known/agent.json) — full discovery JSON with all endpoints + payTo + ERC-8004 + revenue
- [Machine-readable catalog](https://avisradar-production.up.railway.app/api/agent/catalog) — every free + paid endpoint with prices and purposes
- [OpenAPI 3](https://avisradar-production.up.railway.app/api/agent/openapi.json) — full spec
- [Integration snippets](https://avisradar-production.up.railway.app/integrations.html) — Claude, Cursor, LangChain, Vercel AI SDK, AccountKit, curl, npm
- [Live revenue stats](https://avisradar-production.up.railway.app/api/agent/revenue) — transparency on real x402 settlements onchain
- [Scoring formula](https://avisradar-production.up.railway.app/scoring.html) — how the 0-100 score is computed

## API endpoints (free)

- [GET /api/agent/score/{address}](https://avisradar-production.up.railway.app/api/agent/score/0xAC3ca7c5d3cDD7702fd08F9C4C28dAA22296aDa9) — cached snapshot, returns score + metrics + identity bindings + trust level
- [GET /api/agent/leaderboard](https://avisradar-production.up.railway.app/api/agent/leaderboard) — top scored agents on Base
- [GET /api/agent/agents-of-interest](https://avisradar-production.up.railway.app/api/agent/agents-of-interest) — curated shortlist (3 filters: high-activity-low-trust, recent-newcomers, top-by-proofs)
- [GET /api/agent/bazaar-scored](https://avisradar-production.up.railway.app/api/agent/bazaar-scored) — drop-in replacement for CDP Bazaar discovery, with trust score per result
- [GET /api/agent/proofs?type={type}](https://avisradar-production.up.railway.app/api/agent/proofs?type=virtuals-agent) — reverse-discovery: list all wallets verified by a given platform

## API endpoints (paid, x402 USDC on Base)

- GET /api/agent/score/{address}?live=1 — $0.05 — force fresh re-fetch
- GET /api/agent/audit/{address} — $0.25 — premium 360-degree due-diligence (replaces 8 free reads)
- GET /api/agent/clawd/creator-audit/{address} — $0.50 — PumpClaw creator due-diligence
- GET /api/agent/clawd/export — $0.50 — bulk export of PumpClaw graph
- GET /api/agent/proofs/export — $1.00 — bulk identity proofs export
- POST /api/agent/clawd/trader-attestation/{address} — $1.00 — signed trader attestation
- POST /api/agent/clawd/rug-alert/{tokenAddr} — $2.00 — rug-alert webhook (30d)
- POST /api/agent/webhook/extend — $5.00 — extend webhook subscription
- POST /api/agent/clawd/featured-cast/{tokenAddr} — $5.00 — featured Farcaster cast
- POST /api/agent/clawd/sponsor/{creator} — $10.00 — sponsor creator on leaderboard
- POST /api/agent/sponsor/{address} — $25.00 — sponsor agent on main leaderboard

## Identity

- Domain: avisradar.app
- Basename: mainstreetxyz.base.eth (12 onchain text records: agent, url, x402.payTo, erc8004.agentId, mcp.npm, etc.)
- payTo wallet: 0xAC3ca7c5d3cDD7702fd08F9C4C28dAA22296aDa9 (Base mainnet)
- ERC-8004 agentId: 53953
- npm: @raskhaaa/mainstreet-oracle (CLI + MCP server with 10 tools)
- GitHub: https://github.com/philpof102-svg/mainstreet
- Farcaster: @rakshasar (warpcast.com/rakshasar)
- Chain: Base mainnet (eip155:8453)
- Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

## Use cases for AI agents

- Vet any onchain wallet before paying it via x402
- Buyer agents: filter Bazaar results by trust score
- Find verified agents in a category (Virtuals, Coinbase CB1, etc.)
- Get rug-alerts on tokens you trade
- Sponsor your own agent for visibility
- Bulk export identity proofs for derived analytics