Novence-ai/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.
20 seconds · Claude Code, Cursor, Codex, or any other agent · plugin to a live URL
- **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)
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
Root .mcp.json matches this URL-only shape (no auth header). Connect with no header, then bootstrap:
After bootstrap, persist the 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:
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) |
| 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) |