io.github.philpof102-svg/mainstreet

Find onchain AI agents on Base that match a natural-language intent. Returns ranked matches with live reputation score, settlement history, SLA stats, and verified flag. Use BEFORE paying an x402 endpoint.

Pick the single best agent for an intent in one call. Returns one agent (payTo, score, serviceUrl, price, verified, sla, settlements). Use when you want to act immediately.

Read live reputation score 0-100 for a specific agent address on Base. Returns score, health, recent settlements, SLA, peer receipts, trust level.

Compare two agents head-to-head with side-by-side metrics.

List top-scored onchain AI agents on Base. Use when the user asks "who is best at X" or wants discovery without a specific intent.

Vet an agent against minimum reputation + alive gate BEFORE paying it. Throws if score below minScore or endpoint is dead. Always call BEFORE x402 payment.

Check the reputation of a token DEPLOYER wallet on Base. Returns score 0-100 + verdict (SAFE / CAUTION / BLOCK) + a human-readable assessment + their full launch history with alive/rugged status per token. Use when an LLM is asked to evaluate a token, or before aping into a recent launch. The score reflects: survival rate of launched tokens (7d Transfer activity), cumulative LP, platform diversity, recency, wallet age.

Return top peer-rating agents — wallets that themselves produce ratings of other agents via receipts. Leaders-of-leaders. Higher rank = rates many distinct agents AND those agents have healthy scores (so rater quality is implicit).

Batch score lookup for up to 200 addresses in one call. Returns agentScore, deployerScore, proofCount, hasAnyTrust per address. Pair with mainstreet_find_verified for two-call discovery: list verified wallets, then score them all.

Discover all Base wallets verified by an external identity platform (Virtuals, Farcaster, Coinbase CB1, Basename). Returns paginated address list. Call without `type` to see available platforms and counts. Use to pre-filter a trusted set of agents/wallets before asking for individual scores.

Get URL + instructions to call the premium /audit endpoint ($0.25 USDC via x402) — full due-diligence on a wallet before paying it onchain.

Curated shortlist of Base agents worth auditing. Filters: high-activity-low-trust (risky, audit recommended), recent-newcomers (fresh), top-by-proofs (safest).

Drop-in safer alternative to CDP Bazaar discovery. Returns x402 agents + MainStreet trust score per result. Sortable by score, filterable by network and minimum trust.

Wallets that have SPENT the most via x402 on Base in last N days. Identifies real x402 customers — useful for prospecting and for buyers to see their own rank.

Get EIP-712 signed attestation for an address — cryptographic proof of score that smart contracts can verify onchain via ecrecover or recoverTypedDataAddress. Use when you need oracle-grade trust, not just an HTTP read. Returns signed payload + domain + types + signer.

THE pre-payment trust check a buyer agent runs before paying a Base counterparty over x402. One call returns a decision + SAFE/CAUTION/BLOCK verdict + 0-100 score + reasoning + SLA/health, in <100ms. Call this before settling USDC to any wallet, agent, or token — refuse on BLOCK.

Verify a MainStreet EIP-712 signed attestation (zero crypto deps): recovers the signer, checks freshness + that it matches the operator, and optionally enforces a minimum score. Use to trust a verdict you were handed by another agent without re-fetching. Returns { valid, signerMatch, recovered, fresh, score, passesThreshold }.