Novence MCP
Hosted Model Context Protocol server for Novence — static site hosting for AI agents.
- 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.
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.
Cursor / shell
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 |
get_upload_url / get_upload_urls_batch / confirm_upload / confirm_uploads_batch | Upload site files |
list_files / get_file / delete_file | Manage project files |
deploy / get_deployment_status / get_preview_url | Publish and poll until live |
run_checks / get_checks_results | Quality checks (Lighthouse, a11y, links) |
configure_custom_domain / get_domain_status | Custom domains |
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.
Directories / Glama
Do not run this image as a substitute for the hosted MCP. After a Glama maintainer deploys it:
- Open https://glama.ai/mcp/servers/Novence-ai/mcp/admin/dockerfile
- Deploy, then Make Release
npm ci
npm run catalog:smoke
License
MIT — see LICENSE.