--- title: "AR-ACT-09: NLWeb /ask endpoint | Agent Ready Checklist" description: "AR-ACT-09 (MAY, Act layer): NLWeb /ask endpoint. What it asks, the evidence, the command that verifies it and the fix on 19 platforms." canonical: https://agentreadychecklist.com/checklist/ar-act-09 site: "Agent Ready Checklist" last_updated: 2026-11-05 section: "Checklist" --- # AR-ACT-09: NLWeb /ask endpoint | Agent Ready Checklist > AR-ACT-09 (MAY, Act layer): NLWeb /ask endpoint. What it asks, the evidence, the command that verifies it and the fix on 19 platforms. Source: https://agentreadychecklist.com/checklist/ar-act-09 Site: Agent Ready Checklist Last reviewed: 2026-11-05 Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search) Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free). # AR-ACT-09: NLWeb /ask endpoint AR-ACT-09 is a MAY on the act layer: Content-heavy sites may serve an NLWeb /ask endpoint and expose the same ask tool over MCP. It applies to publishers, catalogs and docs. 19 of 19 platforms have a recipe below, 15 of them workarounds. No kit check covers it, so the page gives a manual test. 2 cited facts back it. ## The requirement Identifier AR-ACT-09 Level MAY Layer Act Applies to publishers, catalogs and docs Checked by Ora, matched on this site Ora check [nlweb-ask](#ora) The statement Content-heavy sites may serve an NLWeb /ask endpoint and expose the same ask tool over MCP. ## Why - The spec says /ask takes a natural-language question and returns schema.org-shaped results.primary source: [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md), read 2026-11-04 - AR-ACT-09 was added in v2.0 as MAY.primary source, 2026-10-20: [github.com/agentready-org/standard/blob/main/CHANGELOG.md](https://github.com/agentready-org/standard/blob/main/CHANGELOG.md), read 2026-11-04 ## How to verify No Verify Kit check covers this row, so the test is manual. ### The one-line version ```bash curl -s "/ask?query=pricing" | jq -e "." ``` curl -s "/ask?query=pricing" | jq -e "." returns JSON. ## Verify with Ora One check in Ora's catalogue (contract 1.38.0, read 2026-11-05) read this row. Each entry says what the check looks at and why this page lists it. - `nlweb-ask` NLWeb /ask endpoint Looks for an NLWeb /ask endpoint that answers natural-language questions about the site. Marked emerging. Usability, 1 point, emerging; catalogue applicability domain-only. Listed because: same name, `nlweb`. ### Run just these checks ```bash curl -s -X POST https://ora.ai/api/scan/checks -H 'content-type: application/json' -d '{"url":"https://example.com","checkIds":["nlweb-ask"]}' ``` This calls the endpoint Ora documents for re-verifying a fix. It sends no cache, returns a result for each id and no total score, and spends one scan from the daily budget. Replace the URL with yours. [How to re-verify one fix](https://agentreadychecklist.com/guides/re-verify-one-fix-with-ora/). ### Or audit the whole site ```bash npx ax@0.10 audit https://example.com --min-score 70 ``` ### Related checks This check reads something near the row but asks for more than the row does. A site that meets the row can score nothing or lose points on it, so it is not counted as a test of the row and is left out of the command above. - `nlweb-streaming` NLWeb streaming support Tests that the /ask endpoint streams results as they are found. The row asks for an /ask endpoint, not for streaming, so a site that meets the row can score nothing here. Ora marks it emerging. Usability, 1 point, emerging; catalogue applicability domain-only. Exit code 1 means the score is below the number you passed, so the same line gates a deploy: [the CI recipe](https://agentreadychecklist.com/guides/gate-deploys-on-agent-readiness-in-ci/). [Why this site recommends Ora, and where it falls short](https://agentreadychecklist.com/verify-with-ora/). ## Fix it on your platform ### Next.js (App Router)recipe Add a Route Handler at app/ask/route.ts that exports GET and returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. Next.js 16.x (npm latest 16.4.5, read 2026-11-04); docs at nextjs.org/docs/app. Derived from Next.js's documentation read on 2026-11-04. [nextjs.org/docs/app/api-reference/file-conventions/route](https://nextjs.org/docs/app/api-reference/file-conventions/route) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Next.js (App Router) recipes](https://agentreadychecklist.com/platforms/nextjs-app-router/#ar-act-09) ### Astroworkaround A static Astro build cannot answer a POST or build a response per request, and on-demand endpoints need a server adapter. Add a server adapter and an on-demand endpoint at src/pages/ask.ts with export const GET and prerender = false, returning schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. Astro 7.x (npm latest astro 7.4.5, @astrojs/sitemap 3.7.4, read 2026-11-04). Derived from Astro's documentation read on 2026-11-04. [docs.astro.build/en/guides/endpoints/](https://docs.astro.build/en/guides/endpoints/) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Astro recipes](https://agentreadychecklist.com/platforms/astro/#ar-act-09) ### Nuxtrecipe Add a server route at server/routes/ask.ts with defineEventHandler that returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. Nuxt 4.x (npm latest nuxt 4.6.4, @nuxtjs/robots 7.0.2, @nuxtjs/sitemap 9.1.0, read 2026-11-04). Derived from Nuxt's documentation read on 2026-11-04. [nuxt.com/docs/4.x/directory-structure/server](https://nuxt.com/docs/4.x/directory-structure/server) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Nuxt recipes](https://agentreadychecklist.com/platforms/nuxt/#ar-act-09) ### SvelteKitrecipe Add src/routes/ask/+server.ts that exports GET and returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. SvelteKit (npm latest @sveltejs/kit 3.1.1, read 2026-11-04); docs at svelte.dev/docs/kit. Derived from SvelteKit's documentation read on 2026-11-04. [svelte.dev/docs/kit/routing](https://svelte.dev/docs/kit/routing) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All SvelteKit recipes](https://agentreadychecklist.com/platforms/sveltekit/#ar-act-09) ### Remix and React Router (framework mode)recipe Add a resource route at /ask with a loader that returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. React Router framework mode (npm latest react-router 8.5.1; Remix v2 @remix-run/node 2.17.5, read 2026-11-04); docs at reactrouter.com. Derived from Remix and React Router's documentation read on 2026-11-04. [reactrouter.com/how-to/resource-routes](https://reactrouter.com/how-to/resource-routes) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Remix and React Router (framework mode) recipes](https://agentreadychecklist.com/platforms/remix-react-router/#ar-act-09) ### Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)workaround On Cloudflare Pages, code runs through Pages Functions; a host without functions serves files only. Put a function at /ask that returns schema.org-shaped JSON for the query parameter, or run the handler on a subdomain or API domain you control. Mirror the same ask tool over MCP. Host documentation as published on 2026-11-04 (no version numbers; config files \_headers, \_redirects, vercel.json, 404.html). Derived from Plain static hosting's documentation read on 2026-11-04. [developers.cloudflare.com/pages/functions/](https://developers.cloudflare.com/pages/functions/) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront) recipes](https://agentreadychecklist.com/platforms/static-hosting/#ar-act-09) ### WordPress and Elementorworkaround WordPress REST routes are registered with register\_rest\_route() and live under /wp-json/. Register the handler with register\_rest\_route() and expose it at /ask with a web server rewrite, or run it on a subdomain or API domain you control. It returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. WordPress 7.1.4 (core release from the version-check API), Elementor 4.3.6 (plugin directory, updated 2026-11-02), Yoast SEO 28.8 noted for llms.txt; docs read 2026-11-04. Derived from WordPress and Elementor's documentation read on 2026-11-04. [developer.wordpress.org/rest-api/extending-the-rest-api/adding-custom-endpoints/](https://developer.wordpress.org/rest-api/extending-the-rest-api/adding-custom-endpoints/) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All WordPress and Elementor recipes](https://agentreadychecklist.com/platforms/wordpress-elementor/#ar-act-09) ### Shopify (Online Store 2.0 themes)workaround Shopify's documented route for your own endpoints is an app proxy under /apps/. Serve it through an app proxy under /apps/, returning schema.org-shaped JSON for the query parameter, or run it on a subdomain or API domain you control. Mirror the same ask tool over MCP. Hosted SaaS, Online Store 2.0 Liquid themes, docs read 2026-11-04; storefront behaviour probed live on one Shopify store the same day. Derived from Shopify's documentation read on 2026-11-04. [shopify.dev/docs/apps/build/online-store/app-proxies](https://shopify.dev/docs/apps/build/online-store/app-proxies) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Shopify (Online Store 2.0 themes) recipes](https://agentreadychecklist.com/platforms/shopify/#ar-act-09) ### Webflowworkaround Webflow runs server code through Webflow Cloud, serverless hosting for Next.js or Astro apps connected to a site. Deploy a small Webflow Cloud app (Next.js or Astro) connected to the site and add the handler there, returning schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. Hosted SaaS, help center articles read 2026-11-04 (updated dates 2024-10-14 to 2026-10-29). Derived from Webflow's documentation read on 2026-11-04. [help.webflow.com/hc/en-us/articles/40846212086035-Webflow-Cloud-overview](https://help.webflow.com/hc/en-us/articles/40846212086035-Webflow-Cloud-overview) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Webflow recipes](https://agentreadychecklist.com/platforms/webflow/#ar-act-09) ### Framerworkaround Framer Static Files hosts uploaded files at a path you choose, and the page describes no request handlers. The documentation read lists no built-in feature for this row. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the site. Mirror the same ask tool over MCP. Hosted SaaS, help articles read 2026-11-04 (marked updated 2026-09-15). Derived from Framer's documentation read on 2026-11-04. [framer.com/help/articles/static-files/](https://www.framer.com/help/articles/static-files/) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Framer recipes](https://agentreadychecklist.com/platforms/framer/#ar-act-09) ### Wix (Wix Editor and Wix Studio)workaround Wix sites run request handlers through Velo HTTP functions, which the cited page describes as an API a site exposes, and not as serving /mcp, /ask or /.well-known paths. Workaround: expose the /ask endpoint as a Velo HTTP function (backend/http-functions.js exports get\_ and post\_ functions), or run it on a subdomain or API domain you control, and advertise its address from llms.txt, because the function is not served at /ask. It returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. Hosted SaaS, help center read 2026-11-04. Derived from Wix's documentation read on 2026-11-04. [dev.wix.com/docs/velo/articles/getting-started/expose-an-api](https://dev.wix.com/docs/velo/articles/getting-started/expose-an-api) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Wix (Wix Editor and Wix Studio) recipes](https://agentreadychecklist.com/platforms/wix/#ar-act-09) ### Squarespace (version 7.1)workaround Squarespace's developer documentation covers the Commerce APIs and the Custom Code Specification, and describes no way to run a request handler on a site. Not possible on this platform without outside help. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the site. Mirror the same ask tool over MCP. Hosted SaaS, version 7.1 sites, help center read 2026-11-04 (articles updated 2026-07-17 to 2026-11-03). Derived from Squarespace's documentation read on 2026-11-04. [developers.squarespace.com/custom-code](https://developers.squarespace.com/custom-code) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Squarespace (version 7.1) recipes](https://agentreadychecklist.com/platforms/squarespace/#ar-act-09) ### HubSpot CMS (Content Hub)workaround HubSpot builds new serverless functions with developer projects, where each function's configuration file sets its own endpoint path and methods, and the cited page describes functions for CMS websites without serving /mcp, /ask or /.well-known; design manager functions are served from /\_hcms/api/ and are being sunset. Workaround: build the /ask endpoint as a HubSpot project function, which gets its own endpoint path and methods, or run it on a subdomain or API domain you control, and advertise its address from llms.txt, because the function is not served at /ask. It returns schema.org-shaped JSON for the query parameter. Mirror the same ask tool over MCP. Hosted SaaS, Content Hub, knowledge base and developer docs read 2026-11-04. Derived from HubSpot CMS's documentation read on 2026-11-04. [developers.hubspot.com/docs/cms/start-building/features/serverless-functions/overview](https://developers.hubspot.com/docs/cms/start-building/features/serverless-functions/overview) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All HubSpot CMS (Content Hub) recipes](https://agentreadychecklist.com/platforms/hubspot-cms/#ar-act-09) ### Docusaurusworkaround Docusaurus is a static site generator, and its deployment page covers building static files and no server. The documentation read lists no built-in feature for this row. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the site. Mirror the same ask tool over MCP. 3.10.2 (npm @docusaurus/core latest, read 2026-11-04). Derived from Docusaurus's documentation read on 2026-11-04. [docusaurus.io/docs/deployment](https://docusaurus.io/docs/deployment) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Docusaurus recipes](https://agentreadychecklist.com/platforms/docusaurus/#ar-act-09) ### Mintlifyworkaround The documentation read lists no built-in feature for this row. The documentation read lists no built-in feature for this row. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the docs. Mirror the same ask tool over MCP. Hosted SaaS, docs read 2026-11-04. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Mintlify recipes](https://agentreadychecklist.com/platforms/mintlify/#ar-act-09) ### GitBookworkaround The documentation read lists no built-in feature for this row. Not possible on this platform without outside help. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the docs. Mirror the same ask tool over MCP. Hosted SaaS, docs read 2026-11-04. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All GitBook recipes](https://agentreadychecklist.com/platforms/gitbook/#ar-act-09) ### ReadMeworkaround The documentation read lists no built-in feature for this row. The documentation read lists no built-in feature for this row. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the docs. Mirror the same ask tool over MCP. Hosted SaaS, docs read 2026-11-04. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All ReadMe recipes](https://agentreadychecklist.com/platforms/readme/#ar-act-09) ### Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround PWA Kit adds routes in ssr.js with app.get. Add a route for /ask in ssr.js that returns schema.org-shaped JSON for the query parameter, or run it as a separate service on a subdomain or API domain you control. Mirror the same ask tool over MCP. Hosted SaaS (B2C Commerce help release 264.0.0); PWA Kit retail-react-app 10.3.0 and pwa-kit-runtime 3.21.0 on npm, read 2026-11-04. Derived from Salesforce B2C Commerce's documentation read on 2026-11-04. [developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html) and [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront) recipes](https://agentreadychecklist.com/platforms/salesforce-commerce-cloud/#ar-act-09) ### Adobe Commerce and Magento Open Sourceworkaround The documentation read lists no built-in feature for this row. Not possible on this platform without outside help. Workaround: run the /ask endpoint on a subdomain or API domain you control, returning schema.org-shaped JSON for the query parameter, and link it from the site. Mirror the same ask tool over MCP. 2.4.9 (GitHub tag published 2026-05-12; 2.4.10-alpha1 tagged 2026-10-13); release notes read 2026-11-04. Generic step from the AgentReady specification; not platform-specific. [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md). [All Adobe Commerce and Magento Open Source recipes](https://agentreadychecklist.com/platforms/adobe-commerce/#ar-act-09) ## What it does not do - Not measured in the studies. - Does not replace crawlable pages. ## Common mistakes - An /ask endpoint that needs a key the agent cannot get. ## Related - Term: [NLWeb /ask](https://agentreadychecklist.com/glossary/nlweb-ask/) ## Sources - [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md)read 2026-11-04 - [github.com/agentready-org/standard/blob/main/CHANGELOG.md](https://github.com/agentready-org/standard/blob/main/CHANGELOG.md)read 2026-11-04 - [nextjs.org/docs/app/api-reference/file-conventions/route](https://nextjs.org/docs/app/api-reference/file-conventions/route)read 2026-11-04 - [docs.astro.build/en/guides/endpoints/](https://docs.astro.build/en/guides/endpoints/)read 2026-11-04 - [nuxt.com/docs/4.x/directory-structure/server](https://nuxt.com/docs/4.x/directory-structure/server)read 2026-11-04 - [svelte.dev/docs/kit/routing](https://svelte.dev/docs/kit/routing)read 2026-11-04 - [reactrouter.com/how-to/resource-routes](https://reactrouter.com/how-to/resource-routes)read 2026-11-04 - [developers.cloudflare.com/pages/functions/](https://developers.cloudflare.com/pages/functions/)read 2026-11-04 - [developer.wordpress.org/rest-api/extending-the-rest-api/adding-custom-endpoints/](https://developer.wordpress.org/rest-api/extending-the-rest-api/adding-custom-endpoints/)read 2026-11-04 - [shopify.dev/docs/apps/build/online-store/app-proxies](https://shopify.dev/docs/apps/build/online-store/app-proxies)read 2026-11-04 - [help.webflow.com/hc/en-us/articles/40846212086035-Webflow-Cloud-overview](https://help.webflow.com/hc/en-us/articles/40846212086035-Webflow-Cloud-overview)read 2026-11-04 - [framer.com/help/articles/static-files/](https://www.framer.com/help/articles/static-files/)read 2026-11-04 - [dev.wix.com/docs/velo/articles/getting-started/expose-an-api](https://dev.wix.com/docs/velo/articles/getting-started/expose-an-api)read 2026-11-04 - [developers.squarespace.com/custom-code](https://developers.squarespace.com/custom-code)read 2026-11-04 - [developers.hubspot.com/docs/cms/start-building/features/serverless-functions/overview](https://developers.hubspot.com/docs/cms/start-building/features/serverless-functions/overview)read 2026-11-04 - [docusaurus.io/docs/deployment](https://docusaurus.io/docs/deployment)read 2026-11-04 - [developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html)read 2026-11-04 - [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05 - [ora.ai/llms-full.txt](https://ora.ai/llms-full.txt?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05 - [registry.npmjs.org/ax, the ax README](https://registry.npmjs.org/ax)read 2026-11-05 Verify with Ora The scanner this site recommends for the whole checklist. 132 checks, a score out of 100, no account. `npx ax@0.10 audit --min-score ` [Why Ora, and its limits](https://agentreadychecklist.com/verify-with-ora/) Fix it on - [Next.js (App Router)recipe](#p-nextjs-app-router) - [Astroworkaround](#p-astro) - [Nuxtrecipe](#p-nuxt) - [SvelteKitrecipe](#p-sveltekit) - [Remix and React Router (framework mode)recipe](#p-remix-react-router) - [Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)workaround](#p-static-hosting) - [WordPress and Elementorworkaround](#p-wordpress-elementor) - [Shopify (Online Store 2.0 themes)workaround](#p-shopify) - [Webflowworkaround](#p-webflow) - [Framerworkaround](#p-framer) - [Wix (Wix Editor and Wix Studio)workaround](#p-wix) - [Squarespace (version 7.1)workaround](#p-squarespace) - [HubSpot CMS (Content Hub)workaround](#p-hubspot-cms) - [Docusaurusworkaround](#p-docusaurus) - [Mintlifyworkaround](#p-mintlify) - [GitBookworkaround](#p-gitbook) - [ReadMeworkaround](#p-readme) - [Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround](#p-salesforce-commerce-cloud) - [Adobe Commerce and Magento Open Sourceworkaround](#p-adobe-commerce) Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.