Novence MCP
OfficialNovence MCP is a hosted MCP server for AI agents to create, upload, deploy, and manage static sites.
Sign up via
bootstrap, verify email OTPs, resend verification, and reissue API keys.Create, list, inspect, update, and manage hosting projects, including collaborators and invites.
Get presigned upload URLs, upload/confirm files, and list, inspect, or delete staged files.
Deploy sites, poll deployment status, and retrieve public preview URLs.
Run and read Lighthouse, accessibility, and link quality checks.
Configure custom domains and check DNS/TLS status.
Create and manage forms, list submissions, and delete submission PII.
Read account/project quotas, usage, analytics, and account snapshots.
Mint short-lived account console sessions and get a local console kit.
Start Stripe Checkout or MPP plan upgrades and open the billing portal.
Provides quality checks for hosted sites using Lighthouse, including performance, accessibility, and link audits.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Novence MCP Deploy my static site and give me the live URL."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Novence MCP
Hosted Model Context Protocol server for Novence — static site hosting for AI agents.
Your agent can build the site. Then in seconds, give it somewhere to ship.
Endpoint:
https://api.novence.ai/mcp(streamable HTTP)Auth: optional to start. Call
bootstrap(email); the session adopts thenv_key. ThenAuthorization: Bearer nv_…for later sessions.Docs: novence.ai/mcp
Privacy: novence.ai/privacy
This repository is the Claude Code plugin / install package (Novence-ai/mcp). The MCP server itself is hosted; there is nothing to run locally.
The Dockerfile and catalog/ stdio adapter are only for MCP directories (Glama). They answer tools/list with public tool schemas. They do not contain the hosting API. End users should use https://api.novence.ai/mcp.
Root .mcp.json (and mcp.json for Cursor / Agent Plugins) is Cursor-safe: URL only, no Claude ${user_config.*} placeholders. After bootstrap, Cursor / shell clients persist auth with env NOVENCE_API_KEY and a Bearer header. The Claude Code plugin keeps Keychain / userConfig.api_key via .claude-plugin/plugin.json inline mcpServers.
Skill for registries: skills/novence-deploy (gh skill install Novence-ai/mcp novence-deploy when available).
Install (Claude Code)
claude plugin marketplace add Novence-ai/mcp
# or: enable from the Claude plugin directory after listing is approvedLeave Novence API key blank. Call bootstrap(email) (MCP). After the live URL, paste the nv_ key in plugin settings (Keychain) and run /reload-plugins so later sessions stay authenticated.
Claude stores the key via plugin userConfig. Empty interpolation is treated as unauthenticated (Bearer / uninterpolated ${user_config.api_key}), so bootstrap works before you fill the field.
Related MCP server: webserver-mcp
Cursor / shell
Root .mcp.json matches this URL-only shape (no auth header). Connect with no header, then bootstrap:
{
"mcpServers": {
"novence": {
"url": "https://api.novence.ai/mcp"
}
}
}After bootstrap, persist the key:
export NOVENCE_API_KEY='nv_…'{
"mcpServers": {
"novence": {
"url": "https://api.novence.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:NOVENCE_API_KEY}"
}
}
}
}One-click install (no key): Add to Cursor
Generic MCP clients
Same as Cursor: URL only first, then add Authorization: Bearer nv_… after bootstrap.
REST fallback if you are not on MCP:
# Deploy first (no email): curl -sS -X POST https://api.novence.ai/v1/demo
curl -sS -X POST https://api.novence.ai/v1/bootstrap \
-H 'Content-Type: application/json' \
-d '{"email":"you@example.com"}'Verify the emailed OTP after the live URL to unlock full Free quotas.
Tools
Tool | Description |
| Signup without a prior |
| Project lifecycle ( |
| Irreversible owner-only delete; |
| Upload site files |
| Manage project files |
| Stage |
| Live |
| Private webmaster brief + inbox (Pro/Scale). Session start: get then list. |
| Publish, poll, preview aliases (Pro/Scale), rollback last 5 |
| One HTML document → |
| Quality checks (Lighthouse, a11y, links) |
| Custom domains (CNAME www → fallback.novence.ai; apex ALIAS or URL-redirect) |
| Forms |
| Paid plans (verified email; after 2nd project or a 402) |
| Quotas, usage, and opt-in site traffic |
| Billing/account console kit (never embed |
Official registry
Published as ai.novence/mcp on registry.modelcontextprotocol.io.
License
MIT — see LICENSE.
Available Tools
43 toolsaccept_project_inviteAccept project inviteAInspect
Accept an invite token (from email or invite_project_member in local/dev). Unverified invitees must pass otp. Returns a project-scoped nv_ key once — never email it. Collaborating uses this project_id; create_project still bills the caller.
Inputs: token (required), otp.
billing_portalBilling portalAInspect
Stripe Customer Portal URL for an existing subscriber (manage/cancel). Not first-time subscribe — use checkout or mpp_upgrade for that.
Inputs: return_url.
bootstrapBootstrap accountAInspect
Create an account + nv_ API key from an email. No Bearer key required. Unverified trial still publishes; OTP/verify_email is AFTER the live URL. Returns apiKey immediately — do not wait for OTP.
Inputs: email (required).
checkoutStripe CheckoutAInspect
Return a Stripe Checkout URL for Pro ($29) or Scale. Requires nv_ + verified email. Use after a 2nd project or a 402 — never after the first live URL.
Inputs: plan, cancel_url, success_url.
configure_custom_domainConfigure custom domainAInspect
Attach a custom domain. For site domains, enables apex+www. Default primary=www with redirect (Vercel-style). Pass primary=apex or redirect=false to change.
Inputs: hostname (required), project_id (required), primary, redirect.
confirm_uploadConfirm uploadAIdempotentInspect
Record one staged file after the client PUT to the presigned URL from get_upload_url. Use confirm_uploads_batch when several files were uploaded. Does not publish the site — call deploy after confirms. Re-confirming the same path updates metadata.
Inputs: path (required), project_id (required), content_type.
confirm_uploads_batchConfirm uploads (batch)AInspect
Confirm many uploads after get_upload_urls_batch PUTs. 200 body is { files, errors }. errors is always an array (empty on full success); retry only failed paths. Use confirm_upload for a single file. Does not deploy.
Inputs: files (required), project_id (required).
create_account_sessionCreate account sessionAInspect
Mint a short-lived mgmt_ token for a local HTML console (account:read, billing:portal, project:members). Never put nv_ keys in HTML.
Inputs: no named parameters.
create_formCreate formAInspect
Create a Novence form on a project (optional — sites may use Formspree/Web3forms instead). Returns submit URLs for edge + public API.
Inputs: name (required), project_id (required), slug, fields, +2 more.
create_projectCreate projectAInspect
Create a new hosting project on the caller's account (counts against the caller's project quota). To edit a shared site, pass that project's project_id to upload/deploy tools instead.
Inputs: name (required), description.
delete_fileDelete fileADestructiveInspect
Remove one path from staging. Does not change the already-live deploy until the next deploy. Irreversible for that staged path; re-upload to restore. Use delete_form_submission for form PII, not this.
Inputs: path (required), project_id (required).
delete_form_submissionDelete form submissionADestructiveInspect
Permanently delete one form submission (PII). Does not disable the form — use update_form status=disabled. Irreversible.
Inputs: form_id (required), project_id (required), submission_id (required).
deployDeploy siteAInspect
Publish the site. Verified accounts run quality checks; unverified accounts skip checks (checkRuns: 0) and still go live. POST returns quickly — poll get_deployment_status until live or failed. Do not retry POST while status is promoting or checking.
Inputs: project_id (required), force.
get_accountGet accountARead-onlyIdempotentInspect
Full account snapshot: profile, subscription, quotas, usage, projects. Use get_quotas_and_usage for limits only; use get_account_console_kit to render a local HTML console. Read-only.
Inputs: no named parameters.
get_account_console_kitGet account console kitARead-onlyIdempotentInspect
JSON kit to write a local novence-console.html: snapshot, HTML template, session mint instructions. Serve on localhost. Use create_account_session for the mgmt_ token; use get_account for JSON without the kit. Read-only.
Inputs: no named parameters.
get_checks_resultsGet check resultsARead-onlyIdempotentInspect
Read Lighthouse, a11y, and link results for a deployment. Omit deployment_id for the latest. Use run_checks to trigger a new cycle; use get_deployment_status for publish/promote state, not scores.
Inputs: project_id (required), deployment_id.
get_deployment_statusGet deployment statusARead-onlyIdempotentInspect
Poll publish state after deploy (queued, checking, promoting, live, failed). Omit deployment_id for the latest. Use get_checks_results for Lighthouse/a11y scores and get_preview_url once live. Read-only; do not retry deploy while promoting or checking.
Inputs: project_id (required), deployment_id.
get_domain_statusGet domain statusARead-onlyIdempotentInspect
Read DNS and TLS status for the project's custom hostname after configure_custom_domain. Do not use this to attach a domain. Poll until verified; returns current hostname and certificate state. Read-only.
Inputs: project_id (required).
get_fileGet fileARead-onlyIdempotentInspect
Return metadata for one staged path (not file bytes). Use list_files to discover paths; use get_upload_url to replace content. Read-only.
Inputs: path (required), project_id (required).
get_preview_urlGet preview URLARead-onlyIdempotentInspect
Return the public https://{suffix}.novence.ai URL for a project. Use get_deployment_status to know if that URL is live yet; use configure_custom_domain for a custom hostname. Read-only.
Inputs: project_id (required).
get_projectGet projectARead-onlyIdempotentInspect
Return one hosting project (name, suffix, settings, membership). Use list_projects to discover IDs. Use get_preview_url for the public URL only, and get_project_usage for quotas on that site. Read-only; does not mutate.
Inputs: project_id (required).
get_project_analyticsGet project analyticsARead-onlyIdempotentInspect
Cookieless edge analytics for a hosted site: pageviews, 404s, top pages, referrers, and countries. Off by default. Enable with update_project_settings analytics_enabled=true. Default last 7 days (max 90). If disabled, returns enabled=false and empty totals.
Inputs: project_id (required), to, from.
get_project_usageGet project usageARead-onlyIdempotentInspect
Per-project usage (storage, deploys, check minutes, bandwidth, forms). Bandwidth is live from edge-served bytes. Use get_quotas_and_usage for account totals; use get_project_analytics for pageviews. Read-only.
Inputs: project_id (required).
get_quotas_and_usageGet quotas and usageARead-onlyIdempotentInspect
Account-level plan limits and current consumption (projects, storage, deploys, bandwidth). Use get_project_usage for one site; use get_account for profile plus quotas together. Read-only snapshot, not a live meter stream.
Inputs: no named parameters.
get_upload_urlGet upload URLAInspect
Get a presigned PUT URL for one site file. content_type is optional (inferred from extension). Use get_upload_urls_batch for multi-file sites, then confirm_upload after the PUT.
Inputs: path (required), project_id (required), content_type.
get_upload_urls_batchGet upload URLs (batch)AInspect
Presign many site files at once (max 100). Prefer this over get_upload_url for multi-file sites. After PUTs, call confirm_uploads_batch, not confirm_upload.
Inputs: files (required), project_id (required).
invite_project_memberInvite project memberAInspect
Invite a collaborator by email. Requires Pro/Scale on the project owner. Only the owner can invite as admin. Creates a new project on the caller's account if you use create_project instead — pass project_id here. Do not share the owner's nv_ key.
Inputs: email (required), project_id (required), role.
leave_projectLeave projectADestructiveInspect
Leave a project you were invited to. Owners cannot leave — transfer or stay. Revokes your project keys. Use remove_project_member if you are the owner removing someone else.
Inputs: project_id (required).
list_filesList filesARead-onlyIdempotentInspect
List staged site files for a project (paths, types, sizes). Use get_file for one path's metadata; use delete_file to remove a path. Read-only; does not deploy.
Inputs: project_id (required).
list_formsList formsARead-onlyIdempotentInspect
List Novence forms on a project (ids, slugs, status). Use update_form to change one; use list_form_submissions to read leads. Not for third-party widgets. Read-only.
Inputs: project_id (required).
list_form_submissionsList form submissionsARead-onlyIdempotentInspect
List visitor submissions for one Novence form (paginated). Use delete_form_submission to remove PII. Not for update_form schema changes. Read-only.
Inputs: form_id (required), project_id (required), limit, offset.
list_project_membersList project membersARead-onlyIdempotentInspect
List members and pending invites for a project. Use invite_project_member to add; use revoke_project_invite for pending tokens; use remove_project_member for accepted collaborators. Read-only.
Inputs: project_id (required).
list_projectsList projectsARead-onlyIdempotentInspect
List hosting projects the caller owns or is invited to (ids, names, suffixes). Use get_project for one project's settings; use get_preview_url for the live URL. Read-only; does not create a project.
Inputs: no named parameters.
mpp_upgradeMPP upgradeAInspect
Start or complete Pro/Scale via Machine Payments Protocol. Requires nv_ + verified email. First call returns a 402 Payment challenge; retry with payment_authorization (Payment credential) or _meta org.paymentauth/credential. Use after a 2nd project or a 402 — never after the first live URL.
Inputs: plan, payment_authorization.
reissue_keyReissue API keyADestructiveInspect
Mint a new account nv_ key from email OTP. No Bearer key required. WARNING: revokes prior account-scoped nv_ keys. Also verifies email if needed.
Inputs: code (required), email (required).
remove_project_memberRemove project memberADestructiveInspect
Remove an accepted collaborator and revoke their project API keys. Owner-only for admins. For a pending invite, use revoke_project_invite instead. Irreversible; they must be invited again.
Inputs: account_id (required), project_id (required).
resend_verificationResend verificationAInspect
Email a new OTP (also used for reissue_key). No Bearer key required. Works when already verified.
Inputs: email (required).
revoke_project_inviteRevoke project inviteADestructiveInspect
Cancel a pending invite so the token no longer works. Does not remove someone who already accepted — use remove_project_member for that. Irreversible for that invite_id; send a new invite_project_member if needed.
Inputs: invite_id (required), project_id (required).
run_checksRun quality checksAInspect
Start a Lighthouse, a11y, and link check cycle on the latest deployment. Does not publish a new deploy — use deploy for that. Then poll get_checks_results (not get_deployment_status) until scores appear. Unverified accounts skip checks on deploy; this still queues a cycle when allowed.
Inputs: project_id (required).
update_formUpdate formAInspect
Patch an existing Novence form (name, slug, fields, notify_email, honeypot, active|disabled). Partial update: omitted fields stay unchanged. Use create_form for a new form; use list_forms to get form_id. Does not delete submissions.
Inputs: form_id (required), project_id (required), name, slug, +4 more.
update_project_memberUpdate project member roleAInspect
Change a collaborator's role. Only the owner can grant or demote admin. Use remove_project_member to revoke access entirely. Does not affect pending invites — use revoke_project_invite for those.
Inputs: role (required), account_id (required), project_id (required).
update_project_settingsUpdate project settingsAInspect
Update project name, description, check thresholds, or analyticsEnabled (cookieless edge traffic; off by default).
Inputs: project_id (required), name, description, check_thresholds, +1 more.
verify_emailVerify emailAInspect
Confirm the email OTP (15 min TTL). No Bearer key required. Call after the first live URL, before checkout/mpp_upgrade.
Inputs: code (required), email (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 43 tools
Most tools target a distinct resource+action, and the descriptions include explicit cross-references to the correct alternative. A few overlapping pairs like get_account vs get_quotas_and_usage and confirm_upload vs confirm_uploads_batch could confuse an agent, but the prose largely prevents mis-selection.
The naming is predominantly verb_noun with clear patterns like create_, list_, get_, update_, delete_, and configure_. A few noun-style commands such as bootstrap, checkout, billing_portal, and mpp_upgrade break the pattern, but they are few and remain readable.
With 43 tools, this is an extremely large MCP surface that exceeds the 25+ threshold. Even though the tools span several subdomains, many are highly granular and could be consolidated, making the overall set feel heavy.
The surface is broad, covering accounts, billing, projects, file uploads, deploys, checks, domains, forms, usage, and membership. Notable lifecycle gaps remain: there is no delete_project or transfer_project despite leave_project telling owners to transfer, and no tool to detach or remove a custom domain.
Maintenance
Related MCP Connectors
Deploy static sites and connect custom domains from Claude, Cursor, or any MCP agent.
Deploy AI-generated HTML/CSS/JS to instant public HTTPS URLs from any MCP-compatible agent.
Agent-native website builder: create, edit, and host websites via MCP
Publish websites with a small backend (KV, SQLite, files). MCP for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to deploy static websites to StaticX, including creating sites, uploading builds, publishing releases, and managing domains.23 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to edit and serve a static website via natural language, providing file management tools over MCP and HTTP hosting.-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to deploy and manage static websites on EdgeOne Pages via the Model Context Protocol.-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to deploy and manage static websites on EdgeOne Pages via a self-hosted MCP server. Supports KV storage and custom domain binding.-