votel-mcp

An MCP server that lets AI assistants manage and publish websites via Votel.

Connect Your AI Client

There are two ways to connect — pick the one that fits your client:

Method	How it works	Best for
Remote (OAuth)	Connect via URL. No install needed.	Claude.ai, ChatGPT, VS Code
Local (API Key)	Run on your machine with npx. Needs Node.js 18+.	Claude Code, Claude Desktop, Cursor, Windsurf, Cline

Remote Setup (OAuth)

No API key or Node.js required. Add the server URL and authorize with your Votel account.

Claude.ai (Pro/Max/Team/Enterprise) — Settings > Integrations > MCP Servers > Add Server:

https://app.votel.ai/mcp

ChatGPT (Pro/Plus/Business/Enterprise) — Settings > MCP Servers > Add:

https://app.votel.ai/mcp

VS Code — Command Palette > "MCP: Add Server" > HTTP:

https://app.votel.ai/mcp

Your client handles the OAuth login flow automatically.

Local Setup (API Key)

Get your API key from Settings > API Keys in your Votel dashboard.

Claude Code

claude mcp add votel-mcp \
  -e VOTEL_API_KEY=sk_your_api_key_here \
  -- npx -y votel-mcp@latest

Claude Desktop / Cursor / Windsurf / Cline

Add to your MCP config file:

{
  "mcpServers": {
    "votel-mcp": {
      "command": "npx",
      "args": ["-y", "votel-mcp@latest"],
      "env": {
        "VOTEL_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Config file locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
• Cursor: .cursor/mcp.json in your project root
• Windsurf: MCP Servers section in Windsurf settings
• VS Code: .vscode/mcp.json in your project root
• Cline: MCP server settings in the Cline extension

Client Compatibility

Client	Local (API Key)	Remote (OAuth)
Claude.ai	—	Yes
ChatGPT	—	Yes
Claude Code	Yes	Yes
Claude Desktop	Yes	Yes (Pro+)
Cursor	Yes	Yes
Windsurf	Yes	Yes
VS Code	Yes	Yes
Cline	Yes	Yes

Available Tools

Tool	Description
list_websites	List all websites for your account
create_website	Create a new website (provisions CDN + storage)
get_website	Get website details, domains, and configuration
delete_website	Delete a website and all its resources
add_domain	Add a custom domain with DNS instructions
remove_domain	Remove a custom domain
verify_domain	Check DNS propagation and SSL status
purge_cache	Purge CDN cache (full or specific URLs)
get_analytics	Get traffic stats, bandwidth, and cache ratio
get_storage_credentials	Get storage credentials for direct file uploads

Example Prompts

Managing sites:

• "What websites do I have?"
• "Create a website called Anderson Legal Group"
• "Add the domain example.com to Anderson Legal Group and show me the DNS records I need to set up"
• "Purge the cache for Anderson Legal Group"
• "How much traffic has Anderson Legal Group gotten this month?"
• "Delete the website called Old Test Site"

Design & publish (one-shot):

• "Design a professional website for a law firm called Harper & Associates and publish it to example.com"
• "Build a sleek dark-themed landing page for a SaaS product called Launchpad and put it live on example.com"
• "Create a clean website for a dentist office called Bright Smile Dental and publish it to example.com"
• "Make a modern site for a real estate agent named Sarah Chen and deploy it to example.com"
• "Design a restaurant website for an Italian place called Nonna's Kitchen with their menu and hours, then publish it to example.com"

Environment Variables

Variable	Required	Default	Description
VOTEL_API_KEY	Yes (local only)	—	Your Votel API key (sk_...)
VOTEL_API_URL	No	https://app.votel.ai	Backend URL

Documentation

Full setup guide with screenshots: docs.votel.ai/ai-websites/mcp-setup

License

MIT