Static hosting for AI agents

How does an agent deploy a static site?

1. Step 01 · Bootstrap

   Connect MCP at https://api.novence.ai/mcp with no key and call bootstrap(email), or POST https://api.novence.ai/v1/bootstrap. Save the nv_ key. Do not wait for OTP — unverified trial still publishes.

2. Step 02 · Project

   Create a project. You get a suffix and live URL shape https://{suffix}.novence.ai/.

3. Step 03 · Upload

   Upload HTML/CSS/JS (batch preferred). Confirm uploads. Static assets only — no SSR, no server routes. Third-party widgets and /data/*.json files are allowed; see /site-data.

4. Step 04 · Deploy & poll

   Create a deployment. Poll GET …/deployments/latest until deployment.status is live or failed — never poll project.status. Checks may be skipped on trial; that is still live.

5. Step 05 · Verify email (after live URL)

   After the site is live, ask for the 6-digit email OTP and call verify_email (MCP) or POST /v1/auth/verify-email to unlock full Free quotas.

6. Step 06 · Domain · forms · pay

   Optional: custom domain, Novence Forms, Stripe Checkout or MPP. Local console-kit dashboard if you want a visual quotas board — see /dashboard.

Then how do I verify and add a domain?

Ask for the 6-digit OTP after the URL is live. Call MCP verify_email or POST https://api.novence.ai/v1/auth/verify-email. That unlocks Free: 1 project, 1 GB storage, 10 GB bandwidth/mo, 20 deploys, 30 check minutes, 1 custom domain, 50 form submissions (as of September 2026). Then novence domains add — CNAME www to fallback.novence.ai, then one apex option (ALIAS or URL-redirect). Details: /domains.

One command, if you have a shell

Agents with shell access can skip the upload dance entirely. --json returns a stable envelope, --no-input guarantees no prompt, and any failure exits non-zero.

NOVENCE_API_KEY=nv_… npx novence deploy ./dist --json --no-input

{
  "ok": true,
  "url": "https://abcd1234.novence.ai/",
  "files": 12,
  "checks": { "passed": true }
}

Without --json the live URL is the only thing on stdout, so URL=$(npx novence deploy ./dist) captures it. Full reference: /cli.

One HTML file

A report, dashboard, or Claude-style artifact is still just static HTML. Skip the upload dance: MCP publish_html (pass the HTML string) or npx novence deploy report.html. Same *.novence.ai URL. Grow it into a site later with the same project_id. Details: /artifacts.

Five surfaces, one plane

Widgets and data files

Static-only is not a dead end. There is no plugin marketplace. Improve the hosted site in the files you upload.

• ·Third-party widgets — paste Cal.com, Snipcart, Shopify Buy Button, GA, or Formspree in HTML. Tags are not stripped.
• ·Baked-in data files — upload /data/menu.json (hours, team, services). Page JS fetches same-origin. Redeploy when the file changes.

Never put nv_ keys in the page. Details: /site-data.

Agent FAQ

Go further

Agencies running outbound rebuild pitches: see the examples playbook and for agencies. Single HTML documents: /artifacts. Quality gates: /checks. Traffic: /analytics. Widgets and data files: /site-data. Security posture: /security. Compare hosts: /compare (PaaS, static-only), vs Netlify, vs Vercel, vs Static.app, vs Surge. Plans: /pricing.