6Frame Verify README

6Frame Verify — pre-launch website QA in 60 seconds

Paste a URL; a real Chromium browser loads it on desktop and mobile and checks what breaks launches: HTTP status, broken links, title / meta description / H1, Open Graph social previews, mobile viewport + horizontal overflow, console errors, load time, image alt text, favicon. You get a shareable report with screenshots and exact fixes. Works for humans (web, $3) and AI agents (MCP / REST).

• Check a site ($3, no account): https://siteverify.dev
• Sample reports: https://siteverify.dev/samples
• Free API key (1 free Quick Check/day): https://siteverify.dev/get-key
• MCP (Streamable HTTP): https://siteverify.dev/mcp

Pricing (live Stripe)

Use from an agent (MCP)

{
  "mcpServers": {
    "6frame-verify": {
      "url": "https://siteverify.dev/mcp",
      "headers": { "Authorization": "Bearer fv_live_..." }
    }
  }
}

No key yet? verify_signup (keyless) creates one instantly, no email needed (email optional). Keyless tools: verify_get_capabilities, verify_quote, verify_signup. With a key: verify_check_site (free daily check → credit → Stripe checkout link for a human), verify_get_job, verify_get_report, verify_get_credits, verify_buy_credits.

Use from a script (REST)

curl -X POST https://siteverify.dev/v1/keys -H 'content-type: application/json' -d '{}'   # email optional
curl -X POST https://siteverify.dev/v1/checks -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -d '{"url":"https://your-site.com"}'

/v1/checks uses today's free Quick Check, else prepaid credit, else returns 402 with a Stripe checkout_url; the check runs automatically once paid. Full spec: /.well-known/openapi.json. Advanced quote → order → job flow is unchanged.

Monorepo

apps/web      Next.js public site + admin + REST/MCP/A2A API
apps/worker  Isolated Playwright Chromium verification worker
apps/cli     `6frame-verify` CLI skeleton
packages/contracts  Zod schemas + OpenAPI fragments
packages/evaluators Deterministic + stub semantic evaluators
packages/config     Shared env validation
db/migrations       PostgreSQL schema

Quickstart (local)

cp .env.example .env
# fill DATABASE_URL, REDIS_URL, STRIPE_*, REPORT_SIGNING_PRIVATE_KEY, API_ENCRYPTION_KEY
pnpm install
pnpm db:migrate
pnpm --filter @6frame/web seed
pnpm dev:web
pnpm dev:worker

Machine discovery

• POST /mcp — MCP Streamable HTTP (discovery + keyless tools work without a key; Bearer fv_live_ for paid tools)
• GET /.well-known/mcp/server-card.json (also /.well-known/mcp, /.well-known/mcp.json) — MCP server card
• GET /server.json — official MCP Registry entry (io.github.bret1976/6frame-verify)
• GET /llms.txt — agent-readable summary
• GET /.well-known/openapi.json (alias /openapi.json)
• GET /.well-known/agent-card.json (alias /.well-known/agent.json) — A2A
• GET /v1/capabilities

Listed on

• Official MCP Registry: io.github.bret1976/6frame-verify — https://registry.modelcontextprotocol.io/v0/servers?search=io.github.bret1976/6frame-verify
• Glama: https://glama.ai/mcp/servers/bret1976/6frame-verify

Hard rules

• Production never uses fake Stripe events, fake browser checks, mock results, or placeholder payment unlocks.
• Jobs queue only after Stripe webhook confirms payment or credit is atomically reserved.
• Stripe secrets live in Railway/Vercel env — never in source.

License

MIT © 6Frame Studio — see LICENSE.