--- title: "Nuxt: agent-ready recipes | Agent Ready Checklist" description: "Every agent-ready recipe for Nuxt: 31 rows of the checklist, the version read, the date and the vendor documentation each step came from." canonical: https://agentreadychecklist.com/platforms/nuxt site: "Agent Ready Checklist" last_updated: 2026-11-05 section: "Platforms" --- # Nuxt: agent-ready recipes | Agent Ready Checklist > Every agent-ready recipe for Nuxt: 31 rows of the checklist, the version read, the date and the vendor documentation each step came from. Source: https://agentreadychecklist.com/platforms/nuxt 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). # Nuxt: agent-ready recipes Nuxt: 31 recipes against the 31 checklist rows, read on 2026-11-04. Nuxt: 29 are direct, 2 are workarounds. Nuxt recipes cite the page they were derived from, or the specification when the step is generic. A Nuxt workaround names the real route: a proxy, an edge function or a domain you control. Version read for Nuxt: Nuxt 4.x. ## Version and documentation read Version Nuxt 4.x (npm latest nuxt 4.6.4, @nuxtjs/robots 7.0.2, @nuxtjs/sitemap 9.1.0, read 2026-11-04) Read on 2026-11-04 Recipes 29 direct, 2 workaround, 0 not possible on the platform robots.txt [nuxt.com/modules/robots](https://nuxt.com/modules/robots). Nuxt Robots module (listed in the official module directory) generates robots.txt and X-Robots-Tag; or write public/robots.txt. Sitemap [nuxt.com/modules/sitemap](https://nuxt.com/modules/sitemap). Nuxt Sitemap module generates sitemap.xml from routes. Structured data [nuxt.com/docs/api/composables/use-head](https://nuxt.com/docs/api/composables/use-head). useHead({ script: \[{ type: "application/ld+json", innerHTML: JSON.stringify(data) }\] }) renders the block in SSR output. Status codes [nuxt.com/docs/api/utils/create-error](https://nuxt.com/docs/api/utils/create-error). throw createError({ statusCode: 404 }) sets the response status on the server; error.vue renders the page. Headers and redirects [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering). routeRules set headers, redirects, prerender and SSR per route pattern. Content negotiation [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server). server/middleware and server/routes (Nitro) can read the Accept header and return markdown. llms.txt [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server). No built-in; server/routes/llms.txt.ts or public/llms.txt. OpenAPI [nuxt.com/docs/guide/directory-structure/public](https://nuxt.com/docs/guide/directory-structure/public). No first-party OpenAPI doc page found for the app; serve public/openapi.json. [The checklist table for Nuxt](https://agentreadychecklist.com/platform/nuxt/checklist/) shows every row with its first step. ## Verify with Ora Nuxt has a direct recipe for 29 rows, and Ora's catalogue (read 2026-11-05) names a matching check for 25 of them, among them AR-FIND-01, AR-FIND-03, AR-FIND-04. After the steps are live, one audit shows which of those fixes the score picks up. ```bash npx ax@0.10 audit https://example.com --min-score 70 ``` One row that Ora checks is a workaround or not possible on Nuxt: [AR-READ-05](https://agentreadychecklist.com/checklist/ar-read-05/) (code-fence-validity, workaround). Ora scores the site as it stands, so a row the platform cannot satisfy stays open until the workaround is in place. Run it again with `--force` after a deploy, so the audit skips Ora's cache. [Gate deploys on it in CI](https://agentreadychecklist.com/guides/gate-deploys-on-agent-readiness-in-ci/), [why this site recommends Ora](https://agentreadychecklist.com/verify-with-ora/), [the crosswalk of rows and checks](https://agentreadychecklist.com/checklist/ora-checks/). ## Recipes, row by row ### [AR-FIND-01](https://agentreadychecklist.com/checklist/ar-find-01/): Do not block agentsrecipe Write public/robots.txt with "User-agent: \*" and "Allow: /", or configure the Robots module without per-bot disallows. Check the host WAF separately. Read 2026-11-04. [nuxt.com/modules/robots](https://nuxt.com/modules/robots) ### [AR-FIND-02](https://agentreadychecklist.com/checklist/ar-find-02/): Answers on one first-party pagerecipe Publish each answer once, as a page on your own domain. Put the fact (price, limit, version) in the page text, give the page one stable address, and link it from the home page and from llms.txt. Keep the page current: a second, older copy elsewhere on the site is the usual way an agent cites the wrong figure. 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) ### [AR-FIND-03](https://agentreadychecklist.com/checklist/ar-find-03/): Sitemap listed in robots.txtrecipe npx nuxi module add sitemap, set site.url in nuxt.config.ts; the module serves /sitemap.xml. Add the Sitemap line to robots.txt (the Robots module adds it when both are installed). Read 2026-11-04. [nuxt.com/modules/sitemap](https://nuxt.com/modules/sitemap) ### [AR-FIND-04](https://agentreadychecklist.com/checklist/ar-find-04/): AI Catalog at .well-knownrecipe Place public/.well-known/ai-catalog.json, or return it from server/routes/.well-known/ai-catalog.json.ts with defineEventHandler(() => catalog). Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server) ### [AR-READ-01](https://agentreadychecklist.com/checklist/ar-read-01/): Answer in the initial HTMLrecipe Keep ssr: true (the default). Load data with useFetch or useAsyncData so it resolves during server rendering; use routeRules { "/docs/\*\*": { prerender: true } } for static docs. Avoid ssr: false or around the answer. Read 2026-11-04. [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering) ### [AR-READ-02](https://agentreadychecklist.com/checklist/ar-read-02/): Real HTTP status codesrecipe In pages throw createError({ statusCode: 404, statusMessage: "Not Found" }) when data is missing. In server/middleware return 429 with setResponseHeader(event, "Retry-After", "60") when throttling. Read 2026-11-04. [nuxt.com/docs/api/utils/create-error](https://nuxt.com/docs/api/utils/create-error) ### [AR-READ-03](https://agentreadychecklist.com/checklist/ar-read-03/): Home page with real linksrecipe Render the home page server side and use NuxtLink, which outputs a href anchors, for docs, product and pricing links. Read 2026-11-04. [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering) ### [AR-READ-04](https://agentreadychecklist.com/checklist/ar-read-04/): Docs that answer agent tasksrecipe For each of your top five agent tasks, write a page that holds the steps as text, in order, with the exact names of the buttons, fields and settings. Steps that exist only in an image, a video or a script-built widget are not in the response a plain fetch receives. Fetch the page with curl and grep for the step. 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) ### [AR-READ-05](https://agentreadychecklist.com/checklist/ar-read-05/): Fenced, language-tagged codeworkaround Nuxt core has no Markdown pipeline. With Nuxt Content write fenced blocks with a language tag; otherwise render 
 yourself.

Read 2026-11-04. [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering)

### [AR-READ-06](https://agentreadychecklist.com/checklist/ar-read-06/): Link the discovery filesrecipe

In app.vue call useHead({ link: \[{ rel: "alternate", type: "text/markdown", href: mdUrl }\] }) and add footer links to /llms.txt and /openapi.json.

Read 2026-11-04. [nuxt.com/docs/api/composables/use-head](https://nuxt.com/docs/api/composables/use-head)

### [AR-READ-07](https://agentreadychecklist.com/checklist/ar-read-07/): Ship llms.txtrecipe

Write public/llms.txt, or generate it in server/routes/llms.txt.ts and prerender it with routeRules { "/llms.txt": { prerender: true } }.

Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server)

### [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/): JSON-LD on key pagesrecipe

useHead({ script: \[{ type: "application/ld+json", innerHTML: JSON.stringify(jsonLd) }\] }) in the page; it is rendered into the SSR HTML.

Read 2026-11-04. [nuxt.com/docs/api/composables/use-head](https://nuxt.com/docs/api/composables/use-head)

### [AR-READ-09](https://agentreadychecklist.com/checklist/ar-read-09/): Advertise a markdown mirrorrecipe

Add the alternate link with useHead, or set a Link header per pattern with routeRules { "/docs/\*\*": { headers: { Link: "<…>; rel=\\"alternate\\"; type=\\"text/markdown\\"" } } }.

Read 2026-11-04. [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering)

### [AR-READ-11](https://agentreadychecklist.com/checklist/ar-read-11/): Pricing as first-party HTMLrecipe

Render pages/pricing.vue server side with plans and limits in a table; load prices with useFetch so they are in the HTML.

Read 2026-11-04. [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering)

### [AR-ACT-01](https://agentreadychecklist.com/checklist/ar-act-01/): Auth an agent can finishrecipe

Run an authorization server, or an identity provider, that issues scoped tokens, and serve its RFC 8414 metadata from the app as the CF-OAUTH-DISCOVERY recipe shows (/platforms/nuxt/#cf-oauth-discovery). Also offer self-serve API keys with documented scopes.

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)

### [AR-ACT-02](https://agentreadychecklist.com/checklist/ar-act-02/): OpenAPI contractrecipe

Put openapi.json in public/ (served from the root) and link it from the footer.

Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/public](https://nuxt.com/docs/guide/directory-structure/public)

### [AR-ACT-03](https://agentreadychecklist.com/checklist/ar-act-03/): MCP over Streamable HTTPrecipe

Add a server route at server/routes/mcp.ts with defineEventHandler that returns the MCP server over Streamable HTTP (a POST answered with JSON or an event stream). Keep a docs MCP public and gate a product MCP with OAuth and PKCE.

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)

### [AR-ACT-04](https://agentreadychecklist.com/checklist/ar-act-04/): MCP server cardrecipe

Place the card at /.well-known/mcp/server-card.json the same way the AR-FIND-04 recipe places the AI Catalog (/platforms/nuxt/#ar-find-04), and give it a serverInfo.name that matches your MCP server. Publish it only if you run an MCP server.

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)

### [AR-ACT-05](https://agentreadychecklist.com/checklist/ar-act-05/): MCP Apps viewrecipe

An MCP Apps view is a ui:// resource listed by resources/list on your MCP server. Add it to the server built for AR-ACT-03 (/platforms/nuxt/#ar-act-03); the platform adds no step of its own. Publish it only if the product has a UI to hand back.

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)

### [AR-ACT-06](https://agentreadychecklist.com/checklist/ar-act-06/): SDKs and a CLIrecipe

Publish the SDK and the CLI from the product's own repository to npm or PyPI; the website platform is not involved. Then show the install command and a first call on a page of your own site so that agents reading the site find them. Verify with curl -s https://registry.npmjs.org//latest.

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)

### [AR-ACT-07](https://agentreadychecklist.com/checklist/ar-act-07/): WebMCP toolsrecipe

Create plugins/webmcp.client.ts (the .client suffix runs it only in the browser) that feature-detects document.modelContext and calls registerTool.

Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/plugins](https://nuxt.com/docs/guide/directory-structure/plugins)

### [AR-ACT-08](https://agentreadychecklist.com/checklist/ar-act-08/): Agent paymentsrecipe

Add a server route at server/routes/paid.ts with defineEventHandler that returns HTTP 402 with a payment payload on the paid path only (x402 or MPP), or a checkout handler. Put no CAPTCHA in front of a verified agent.

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)

### [AR-ACT-09](https://agentreadychecklist.com/checklist/ar-act-09/): NLWeb /ask endpointrecipe

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.

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)

### [AR-ACT-10](https://agentreadychecklist.com/checklist/ar-act-10/): An MCP server or a CLIrecipe

A CLI meets AR-ACT-10 on any platform: publish it as described in the AR-ACT-06 recipe (/platforms/nuxt/#ar-act-06). An MCP server also meets it; how Nuxt hosts one is in the AR-ACT-03 recipe (/platforms/nuxt/#ar-act-03). Do not ship an empty surface to tick the box.

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)

### [CF-CONTENT-SIGNALS](https://agentreadychecklist.com/checklist/cf-content-signals/): Content-Signal linerecipe

Add a Content-Signal line under User-agent: \* in public/robots.txt (or the module source file it merges).

Read 2026-11-04. [nuxt.com/modules/robots](https://nuxt.com/modules/robots)

### [CF-MARKDOWN-NEGOTIATION](https://agentreadychecklist.com/checklist/cf-markdown-negotiation/): Markdown by Acceptrecipe

In server/middleware/markdown.ts read getRequestHeader(event, "accept"); when it includes text/markdown, return the markdown twin for the path with the correct content type.

Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server)

### [CF-PAY-PER-CRAWL](https://agentreadychecklist.com/checklist/cf-pay-per-crawl/): Pay per crawl, HTTP 402workaround

Pay per crawl is a feature of Cloudflare AI Crawl Control, set per Cloudflare zone and in closed beta on 2026-11-04, so Nuxt does not set it, and a crawler is answered 402 only on a zone that has it. The documentation read lists no built-in feature for this row. Workaround: put the domain on a Cloudflare zone, where Nuxt allows a proxy or custom DNS in front, and set the price there. Test with curl -A "GPTBot/1.0".

Derived from Cloudflare's pay per crawl documentation read on 2026-11-04. [developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/](https://developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/) and [developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/](https://developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/)

### [CF-OAUTH-DISCOVERY](https://agentreadychecklist.com/checklist/cf-oauth-discovery/): OAuth discovery filesrecipe

Return the RFC 8414 JSON from server/routes/.well-known/oauth-authorization-server.ts with defineEventHandler.

Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server)

### [CF-AGENT-SKILLS](https://agentreadychecklist.com/checklist/cf-agent-skills/): Agent Skills indexrecipe

Place public/.well-known/agent-skills/index.json and the listed SKILL.md files.

Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/public](https://nuxt.com/docs/guide/directory-structure/public)

### [VERCEL-NEGOTIATION-HEADERS](https://agentreadychecklist.com/checklist/vercel-negotiation-headers/): Markdown headersrecipe

In that middleware set setResponseHeader(event, "Content-Type", "text/markdown; charset=utf-8") and "Vary", "Accept"; add Vary: Accept to HTML routes through routeRules headers.

Read 2026-11-04. [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering)

### [VERCEL-ROBOTS-EXCLUSIONS](https://agentreadychecklist.com/checklist/vercel-robots-exclusions/): Robots exclusionsrecipe

Open the robots.txt that Nuxt serves for your site and read every Disallow; each one must have a reason you can state. How the file is produced here: Nuxt Robots module (listed in the official module directory) generates robots.txt and X-Robots-Tag; or write public/robots.txt.

Derived from Nuxt's documentation read on 2026-11-04. [nuxt.com/modules/robots](https://nuxt.com/modules/robots) and [vercel.com/kb/guide/make-your-site-readable-by-ai-agents](https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents)

## Vendors on this platform

-   [Nuxt](https://agentreadychecklist.com/vendors/nuxt/)Framework, 2 of 11 checklist rows read met by default

## Sources

-   [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=platform)read 2026-11-05
-   [registry.npmjs.org/ax, the ax README](https://registry.npmjs.org/ax)read 2026-11-05
-   [nuxt.com/modules/robots](https://nuxt.com/modules/robots)read 2026-11-04
-   [nuxt.com/modules/sitemap](https://nuxt.com/modules/sitemap)read 2026-11-04
-   [nuxt.com/docs/api/composables/use-head](https://nuxt.com/docs/api/composables/use-head)read 2026-11-04
-   [nuxt.com/docs/api/utils/create-error](https://nuxt.com/docs/api/utils/create-error)read 2026-11-04
-   [nuxt.com/docs/guide/concepts/rendering](https://nuxt.com/docs/guide/concepts/rendering)read 2026-11-04
-   [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server)read 2026-11-04
-   [nuxt.com/docs/guide/directory-structure/public](https://nuxt.com/docs/guide/directory-structure/public)read 2026-11-04
-   [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
-   [nuxt.com/docs/4.x/directory-structure/server](https://nuxt.com/docs/4.x/directory-structure/server)read 2026-11-04
-   [nuxt.com/docs/guide/directory-structure/plugins](https://nuxt.com/docs/guide/directory-structure/plugins)read 2026-11-04
-   [developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/](https://developers.cloudflare.com/ai-crawl-control/features/pay-per-crawl/what-is-pay-per-crawl/)read 2026-11-04
-   [vercel.com/kb/guide/make-your-site-readable-by-ai-agents](https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents)read 2026-11-04

Edition

Data

2026-11-04

Reviewed

2026-11-05

Spec

AgentReady v2.0, 273d2d7

Crawl

13,071 rows, 2026-11-04

Ora

132 checks, contract 1.38.0, 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/)

Method

-   [How rows, commands and rates are made](https://agentreadychecklist.com/method/)
-   [How an Ora check is matched to a row](https://agentreadychecklist.com/checklist/ora-checks/)
-   [Pass rates by rank band](https://agentreadychecklist.com/data/by-rank/)

Sources and read dates sit at the foot of the page.

Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.