is-real-biz

Pay-per-call API that tells AI agents whether a domain is a real business. Built MCP-first. Two payment rails: x402 (autonomous, zero signup) + prepaid credits (50 free checks, no credit card).

🚀 Live: https://is-real-biz.is-real-biz.workers.dev — try it now:

curl -X POST https://is-real-biz.is-real-biz.workers.dev/billing/signup \
  -H 'content-type: application/json' -d '{"email":"you@example.com"}'
# returns: { api_key: "irb_live_...", credits_cents: 250 } — 50 free checks

GET /check?domain=stripe.com   →   { verdict: "real", score: 94, signals: { ... } }

Use cases: KYB / vendor screening, lead qualification, fraud checks, due diligence — anywhere an agent needs to know "is this domain a legit business or a parked/scam/fake site?"

Why agents will find this

Discovery surfaces (over-served on purpose — every agent looks somewhere different):

Plus the tool descriptions in src/tool-descriptions.ts are written for embedding-based tool selection — the way Claude/ChatGPT/Cursor actually pick which tool to call. Lots of natural-language examples, use-case tags, and example queries.

Why agents can pay it

• x402 (spec) — the HTTP 402 payment protocol pushed by Coinbase + Cloudflare. Agents send an X-PAYMENT header, the server verifies + settles via a facilitator in ~2 seconds. Zero signup. No accounts. Sub-cent calls work. Default network is Base Sepolia testnet (free) — flip X402_NETWORK = "base_mainnet" in wrangler.toml to take real payments.
• Prepaid credits — POST /billing/signup with an email returns an API key with 50 free checks. Need more? Redeem an operator-issued promo code at /billing/promo. No credit card, no Stripe, no card-on-file.

Both paths share the same /check endpoint, so any agent that speaks either rail just works.

Zero-cost deploy (≈ 5 minutes)

You only need:

1. A free Cloudflare account (workers.dev subdomain is free forever) — sign up
2. A free Google AI Studio key for Gemini 1.5 Flash (no credit card) — get key

Then:

git clone <this repo> is-real-biz && cd is-real-biz
npm run setup      # runs deploy.sh — creates D1, KV, applies schema, sets secrets, deploys

The script is interactive: it logs you into Cloudflare, provisions D1 + KV, patches wrangler.toml with the IDs, asks for your Gemini key, and deploys. You'll have a live URL like https://is-real-biz.<your-subdomain>.workers.dev.

Manual deploy

npm install
npx wrangler login
npx wrangler d1 create is-real-biz-db          # paste id into wrangler.toml
npx wrangler kv namespace create CACHE         # paste id into wrangler.toml
npx wrangler d1 execute is-real-biz-db --file=./schema.sql --remote
npx wrangler secret put GEMINI_API_KEY
npx wrangler deploy

Optional secrets

npx wrangler secret put ADMIN_TOKEN     # to mint promo codes via POST /admin/promo
npx wrangler secret put X402_PAY_TO     # your 0x address to enable x402 payments

Try it

# 1. Get a free key (50 checks included)
curl -X POST https://YOUR-WORKER-URL/billing/signup \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com"}'

# 2. Check a domain
curl 'https://YOUR-WORKER-URL/check?domain=stripe.com' 

... [View full README on GitHub](https://github.com/smart-link-t/is-real-biz#readme)