Skip to main content
Glama

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 the nv_ key. Then Authorization: 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 approved

Leave 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

bootstrap / verify_email / resend_verification / reissue_key

Signup without a prior nv_ key; OTP after live URL

create_project / list_projects / get_project / update_project_settings

Project lifecycle (share_gate_emails OTP on *.novence.ai only; site_mcp visitor MCP on Pro/Scale; data_edit_emails + data_edit_names owner /edit on Pro/Scale)

delete_project

Irreversible owner-only delete; confirm must be the project's exact name or suffix

get_upload_url / get_upload_urls_batch / confirm_upload / confirm_uploads_batch

Upload site files

list_files / get_file / delete_file

Manage project files

set_redirects

Stage /_redirects (SPA: /* /index.html 200); call deploy to apply

put_site_data

Live /data/{name}.json without a deploy (Pro/Scale)

get_site_brief / put_site_brief / list_site_events

Private webmaster brief + inbox (Pro/Scale). Session start: get then list.

deploy / get_deployment_status / get_preview_url / rollback

Publish, poll, preview aliases (Pro/Scale), rollback last 5

publish_html

One HTML document → index.html + deploy (omit project_id to create)

run_checks / get_checks_results

Quality checks (Lighthouse, a11y, links)

configure_custom_domain / get_domain_status

Custom domains (CNAME www → fallback.novence.ai; apex ALIAS or URL-redirect)

create_form / list_forms / update_form / list_form_submissions / delete_form_submission

Forms

checkout / mpp_upgrade / billing_portal

Paid plans (verified email; after 2nd project or a 402)

get_quotas_and_usage / get_project_usage / update_project_settings (analytics_enabled) / get_project_analytics / get_account

Quotas, usage, and opt-in site traffic

create_account_session / get_account_console_kit

Billing/account console kit (never embed nv_ in HTML)

Official registry

Published as ai.novence/mcp on registry.modelcontextprotocol.io. MCP Badge

License

MIT — see LICENSE.

Available Tools

43 tools
accept_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 uploadA
Idempotent
Inspect

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 fileA
Destructive
Inspect

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 submissionA
Destructive
Inspect

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 accountA
Read-onlyIdempotent
Inspect

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 kitA
Read-onlyIdempotent
Inspect

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 resultsA
Read-onlyIdempotent
Inspect

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 statusA
Read-onlyIdempotent
Inspect

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 statusA
Read-onlyIdempotent
Inspect

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 fileA
Read-onlyIdempotent
Inspect

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 URLA
Read-onlyIdempotent
Inspect

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 projectA
Read-onlyIdempotent
Inspect

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 analyticsA
Read-onlyIdempotent
Inspect

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 usageA
Read-onlyIdempotent
Inspect

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 usageA
Read-onlyIdempotent
Inspect

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 projectA
Destructive
Inspect

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 filesA
Read-onlyIdempotent
Inspect

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 formsA
Read-onlyIdempotent
Inspect

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 submissionsA
Read-onlyIdempotent
Inspect

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 membersA
Read-onlyIdempotent
Inspect

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 projectsA
Read-onlyIdempotent
Inspect

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 keyA
Destructive
Inspect

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 memberA
Destructive
Inspect

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 inviteA
Destructive
Inspect

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

    A3.9/5.0

    Scored across 43 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers