MainStreet — Hour 1
5 commands, <60 seconds.

If you're an agent dev landing on this page, you can have MainStreet integrated and returning verdicts before your coffee cools. No registration. No API key. Free 100 calls/day. Credits when you need scale.

1Verify the API is alive (2 sec)

curl -s https://avisradar-production.up.railway.app/api/agent/health | head -c 300

→ status 200, returns version + uptime + indexed counts. If you see {"error":"..."} something is down ; ping @rakshasar.

2Vet any Base wallet (free, <100ms) (5 sec)

curl -s -X POST https://avisradar-production.up.railway.app/api/agent/check \
  -H "content-type: application/json" \
  -d '{"subject":"0xAC3ca7c5d3cDD7702fd08F9C4C28dAA22296aDa9","type":"wallet","depth":"instant"}'

→ compact JSON : { verdict: SAFE | CAUTION | BLOCK, score, attestation, credits_remaining, expires_at }. SAFE = OK to route USDC, CAUTION = surface to user, BLOCK = refuse. Verdict TTL = 300s.

3Install the MCP server in your agent (15 sec)

For Claude Code / Claude Desktop / Cursor / Windsurf / Cline :

claude mcp add --transport http mainstreet https://avisradar-production.up.railway.app/mcp

Or via npm (stdio transport) :

npx @raskhaaa/mainstreet-oracle@latest mainstreet-mcp

→ MCP tools : mainstreet_check, mainstreet_score, mainstreet_search, mainstreet_leaderboard, mainstreet_audit_info, mainstreet_compare, mainstreet_history. Try : "Is 0x... a SAFE counterparty?" in any MCP-aware chat.

4Top up credits (optional, when you scale past 1k/day) (10 sec)

curl -X POST https://avisradar-production.up.railway.app/api/agent/credits/topup \
  -H "content-type: application/json" \
  -d '{"tier":"5","buyer":"0xYourAgentWallet"}'

→ 402 Payment Required with x402 challenge. Your agent's x402 client settles 5 USDC on Base → response with 1100 credits credited. Idempotent on settlement tx hash.

Tiers : $5 → 1100 (+10%), $25 → 6000 (+20%), $100 → 25000 (+25%). Per-call cost : 1 credit for instant, 5 for full.

5Read the signed attestation for downstream verifiers (2 sec)

curl -s https://avisradar-production.up.railway.app/api/agent/attestation/0xAC3ca7c5d3cDD7702fd08F9C4C28dAA22296aDa9

→ EIP-712 typed payload + signature. Verifiable onchain by calling requireMinScore() on MainStreetVerifier at 0x7397adb9713934c36d22aa54b4dbbcd70263592b on Base. ~$0.00003 gas per verify.

That's it. You're integrated.

Your agent can now refuse to pay a BLOCK-rated counterparty, surface a CAUTION verdict in its reasoning trace, or proceed automatically on SAFE. Every verdict is timestamped, signed, and onchain-verifiable.

Common pattern : call /check right before generateText({tools}) or right before signing an x402 settlement. The 300s TTL means you cache the verdict for the next 5 minutes — no per-tool-call cost if your agent loops on the same counterparty.

Where to go next

Full landing Code snippets (12 languages) Score formula Live leaderboard GitHub

If anything broke

One person runs this (Phil). Open an issue at github.com/philpof102-svg/mainstreet or DM @rakshasar. Response within 24h.

MainStreet — Hour 15 commands, <60 seconds.

That's it. You're integrated.

Where to go next

If anything broke

MainStreet — Hour 1
5 commands, <60 seconds.