so users and agents can identify the page.\");\n if (c.label === \"Visible content\") out.push(\"Ensure meaningful content is server-rendered or available without requiring client-side JavaScript.\");\n if (c.label === \"Security headers\") out.push(\"Add HSTS, CSP, X-Content-Type-Options, and clickjacking protection where appropriate.\");\n if (c.label === \"Soft 404\") out.push(\"Return a real 404 status for missing/error pages instead of HTTP 200.\");\n }\n return [...new Set(out)];\n}\n\nasync function verify(rawUrl: string) {\n const target = normalizeInput(rawUrl);\n const { response, finalUrl, responseMs, redirectChain } = await safeFetch(target.toString());\n const contentType = response.headers.get(\"content-type\") || \"unknown\";\n const textual = /text\\/|application\\/(xhtml\\+xml|json|xml|javascript)/i.test(contentType);\n const body = textual ? await readLimited(response) : { text: \"\", truncated: false, bytesRead: 0 };\n const html = body.text;\n const visibleText = stripHtml(html).slice(0, 150000);\n const titleMatch = html.match(/<title[^>]*>([\\s\\S]{0,300}?)<\\/title>/i);\n const title = titleMatch ? titleMatch[1].replace(/\\s+/g, \" \").trim() : null;\n const okStatus = response.status >= 200 && response.status < 400;\n const https = finalUrl.startsWith(\"https://\");\n const securityHeaders = [\"strict-transport-security\", \"content-security-policy\", \"x-content-type-options\", \"x-frame-options\"].filter((h) => response.headers.has(h));\n const soft404Pattern = /\\b(404|not found|page not found|doesn't exist|does not exist|no encontrada|no encontrado)\\b/i;\n const soft404 = response.status >= 200 && response.status < 300 && soft404Pattern.test([title || \"\", visibleText.slice(0, 3000)].join(\" \"));\n const jsShell = /text\\/html/i.test(contentType) && visibleText.length < 80 && /<script\\b/i.test(html);\n const meaningfulContent = !textual || visibleText.length >= 80 || html.length >= 300;\n const redirectCrossHost = redirectChain.some((h) => new URL(h.from).hostname !== new URL(h.to).hostname);\n\n const checks: Check[] = [\n { label: \"HTTP status\", passed: okStatus, detail: `HTTP ${response.status}`, severity: okStatus ? \"info\" : \"critical\" },\n { label: \"HTTPS\", passed: https, detail: https ? \"Encrypted final URL\" : \"Final URL is not HTTPS\", severity: https ? \"info\" : \"warning\" },\n { label: \"Response speed\", passed: responseMs < 2500, detail: `${responseMs} ms`, severity: responseMs < 2500 ? \"info\" : \"warning\" },\n { label: \"Page title\", passed: Boolean(title) || !/text\\/html/i.test(contentType), detail: title || (/text\\/html/i.test(contentType) ? \"No HTML title found\" : \"Not an HTML document\"), severity: \"warning\" },\n { label: \"Visible content\", passed: meaningfulContent, detail: jsShell ? \"Very little visible text; likely client-rendered SPA shell\" : `${visibleText.length} visible characters`, severity: meaningfulContent ? \"info\" : \"critical\" },\n { label: \"Security headers\", passed: securityHeaders.length >= 2, detail: `${securityHeaders.length}/4 detected`, severity: securityHeaders.length >= 2 ? \"info\" : \"warning\" },\n { label: \"Soft 404\", passed: !soft404, detail: soft404 ? \"Page looks like an error page but returned a success status\" : \"No soft-404 signal detected\", severity: soft404 ? \"critical\" : \"info\" },\n ];\n\n let score = 0;\n score += okStatus ? 30 : 0;\n score += https ? 15 : 0;\n score += responseMs < 1000 ? 15 : responseMs < 2500 ? 12 : responseMs < 5000 ? 6 : 0;\n score += (title || !/text\\/html/i.test(contentType)) ? 8 : 0;\n score += meaningfulContent ? 12 : 0;\n score += Math.min(12, securityHeaders.length * 3);\n score += !soft404 ? 8 : 0;\n if (jsShell) score = Math.max(0, score - 8);\n if (soft404) score = Math.min(score, 45);\n if (!okStatus) score = Math.min(score, 40);\n score = Math.min(100, Math.max(0, score));\n\n const verdict = score >= 85 ? \"PASS\" : score >= 60 ? \"REVIEW\" : \"FAIL\";\n const checkedAt = new Date().toISOString();\n const stableEvidence = [target.toString(), finalUrl, response.status, title || \"\", contentType, body.bytesRead, redirectChain.map((h) => `${h.status}:${h.to}`).join(\">\"), await sha256(html)].join(\"|\");\n const evidenceHash = (await sha256(stableEvidence)).slice(0, 32);\n const checkId = (await sha256(`${evidenceHash}|${checkedAt}|${responseMs}`)).slice(0, 20);\n\n return {\n ok: true,\n product: \"VIL Reality Check\",\n version: \"0.5.0\",\n score,\n verdict,\n grade: score >= 95 ? \"A+\" : score >= 85 ? \"A\" : score >= 75 ? \"B\" : score >= 60 ? \"C\" : score >= 45 ? \"D\" : \"F\",\n url: target.toString(),\n finalUrl,\n status: response.status,\n responseMs,\n title,\n contentType,\n bytesRead: body.bytesRead,\n bodyTruncated: body.truncated,\n visibleCharacters: visibleText.length,\n redirectChain,\n redirectCrossHost,\n checkedAt,\n evidenceHash,\n checkId,\n checks,\n recommendations: recommendations(checks),\n note: \"Evidence hash is stable for the retrieved representation; checkId identifies this specific run.\",\n };\n}\n\nconst handler = createMcpHandler(() => {\n const server = new McpServer(\n { name: \"VIL Reality Check\", version: \"0.5.0\", websiteUrl: WEBSITE },\n {\n instructions: \"Use VIL Reality Check before claiming a public website or AI-generated deployment works. Prefer check_deployment for one URL and check_deployments for batches. PASS means strong basic availability evidence; REVIEW means reachable but with material warnings; FAIL means the result could not be confidently verified. This is not a full browser, accessibility, penetration, or business-logic test.\",\n },\n );\n\n server.registerTool(\n \"check_deployment\",\n {\n title: \"Verify a website or deployment\",\n description: \"Verify a public website/deployment and return HTTP status, redirects, HTTPS, response time, content signals, soft-404 detection, security headers, score, verdict, recommendations, stable evidence hash, and per-run check ID.\",\n inputSchema: z.object({ url: z.string().min(1).describe(\"Public HTTP/HTTPS URL or domain to verify\") }),\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },\n },\n async ({ url }) => {\n try {\n const result = await verify(url);\n const recs = result.recommendations.length ? `\\nNext: ${result.recommendations.slice(0, 3).join(\" | \")}` : \"\";\n return {\n content: [{ type: \"text\", text: `${result.verdict} — ${result.score}/100 (${result.grade})\\nHTTP ${result.status} • ${result.responseMs} ms\\n${result.finalUrl}\\nEvidence: ${result.evidenceHash}\\nCheck ID: ${result.checkId}${recs}` }],\n structuredContent: result,\n };\n } catch (e) {\n const message = e instanceof Error ? e.message : \"Verification failed\";\n return { isError: true, content: [{ type: \"text\", text: message }], structuredContent: { ok: false, error: message } };\n }\n },\n );\n\n server.registerTool(\n \"check_deployments\",\n {\n title: \"Verify multiple deployments\",\n description: \"Verify 1-10 public URLs in one request and return a compact portfolio summary plus detailed results.\",\n inputSchema: z.object({\n urls: z.array(z.string().min(1)).min(1).max(10).describe(\"1 to 10 public HTTP/HTTPS URLs or domains\"),\n }),\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },\n },\n async ({ urls }) => {\n const results = await Promise.all(urls.map(async (url) => {\n try { return await verify(url); }\n catch (e) { return { ok: false, url, verdict: \"FAIL\", score: 0, error: e instanceof Error ? e.message : \"Verification failed\" }; }\n }));\n const pass = results.filter((r: any) => r.ok && r.verdict === \"PASS\").length;\n const review = results.filter((r: any) => r.ok && r.verdict === \"REVIEW\").length;\n const fail = results.length - pass - review;\n const summary = { total: results.length, pass, review, fail };\n return {\n content: [{ type: \"text\", text: `Batch complete — ${pass} PASS, ${review} REVIEW, ${fail} FAIL out of ${results.length}.` }],\n structuredContent: { ok: true, summary, results },\n };\n },\n );\n\n server.registerTool(\n \"compare_deployments\",\n {\n title: \"Compare two deployments\",\n description: \"Verify and compare two public deployments, such as preview vs production. Reports whether their retrieved representations match and highlights score, status, title, final URL, and evidence differences.\",\n inputSchema: z.object({\n firstUrl: z.string().min(1).describe(\"First public deployment URL\"),\n secondUrl: z.string().min(1).describe(\"Second public deployment URL\"),\n }),\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },\n },\n async ({ firstUrl, secondUrl }) => {\n try {\n const [first, second] = await Promise.all([verify(firstUrl), verify(secondUrl)]);\n const sameEvidence = first.evidenceHash === second.evidenceHash;\n const differences = {\n score: first.score === second.score ? null : { first: first.score, second: second.score },\n status: first.status === second.status ? null : { first: first.status, second: second.status },\n title: first.title === second.title ? null : { first: first.title, second: second.title },\n finalUrl: first.finalUrl === second.finalUrl ? null : { first: first.finalUrl, second: second.finalUrl },\n evidence: sameEvidence ? null : { first: first.evidenceHash, second: second.evidenceHash },\n };\n const changedFields = Object.entries(differences).filter(([, value]) => value !== null).map(([key]) => key);\n return {\n content: [{\n type: \"text\",\n text: sameEvidence\n ? `MATCH — both deployments produced the same evidence hash.\\n${first.evidenceHash}`\n : `DIFFERENT — deployments do not match.\\nChanged: ${changedFields.join(\", \")}\\nFirst: ${first.verdict} ${first.score}/100\\nSecond: ${second.verdict} ${second.score}/100`,\n }],\n structuredContent: { ok: true, sameEvidence, changedFields, differences, first, second },\n };\n } catch (e) {\n const message = e instanceof Error ? e.message : \"Comparison failed\";\n return { isError: true, content: [{ type: \"text\", text: message }], structuredContent: { ok: false, error: message } };\n }\n },\n );\n\n server.registerTool(\n \"get_service_info\",\n {\n title: \"VIL Reality Check service info\",\n description: \"Returns connection and payment information for VIL Reality Check.\",\n inputSchema: z.object({}),\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n },\n async () => ({\n content: [{ type: \"text\", text: `VIL Reality Check MCP: ${MCP_URL}\\nWebsite: ${WEBSITE}\\nPaid use price: $${PRICE_PER_CHECK_USD.toFixed(2)} USD per premium check\\nPayment method: PayPal direct payment to ${PAYPAL_EMAIL}\\nAutomatic payment verification is not enabled yet; do not claim a payment has been verified automatically.` }],\n structuredContent: {\n name: \"VIL Reality Check\",\n version: \"0.5.0\",\n website: WEBSITE,\n mcpUrl: MCP_URL,\n paidUse: {\n priceUsdPerCheck: PRICE_PER_CHECK_USD,\n method: \"PayPal direct\",\n recipient: PAYPAL_EMAIL,\n automaticVerification: false,\n },\n },\n }),\n );\n\n return server;\n});\n\nexport default handler.fetch;","children",[],[185],["D",1789122864432],[],[18],["D",1789084849126],{"_11":12,"_140":75},{"_11":12,"_135":136,"_74":75,"_30":73,"_137":138,"_139":24},{"_40":86,"_13":16,"_34":37,"_127":93,"_128":-5,"_129":-5,"_130":-5,"_131":-5,"_132":-5,"_133":14,"_134":12},"ctx",{"_55":-5,"_160":233,"_234":235,"_236":237,"_238":24,"_239":24,"_240":24,"_241":158,"_242":-5,"_243":-7,"_244":-7,"_245":26,"_246":24,"_247":24,"_248":-5,"_249":24,"_250":24,"_251":24,"_252":-5},"ENV",{"_204":205,"_206":207,"_208":16,"_209":210,"_211":212,"_213":214,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226,"_227":228,"_229":230,"_231":232},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"] </article></body></html>

History · README.md