mcp-server

deploybase MCP Server

Manage European static site hosting from AI agents via the Model Context Protocol (MCP)

The deploybase MCP Server enables AI coding assistants like Claude Code, Cursor, and Windsurf to deploy and manage static sites on deploybase — the EU-hosted, GDPR-compliant static site hosting platform.

✨ Features

• 🚀 Deploy sites via natural language commands
• 📦 Manage projects — create, update, delete, and configure
• 🔄 CI/CD workflows — trigger deployments, view build logs, promote releases
• 🌐 Custom domains — add domains, verify DNS, manage SSL certificates
• 📤 Share previews — create password-protected preview links
• 🚚 Easy migrations — migrate from Vercel, Netlify, or Cloudflare Pages
• 💰 Billing insights — check build minute usage and plan limits

📦 Installation

Using go install

go install codeberg.org/deploybase/mcp-server@latest

Download Pre-built Binary

Download the latest release for your platform from the releases page.

Build from Source

git clone https://codeberg.org/deploybase/mcp-server.git
cd mcp-server
go build -o deploybase-mcp .

🔧 Configuration

Getting an API Key

1. Sign up at deploybase.eu
2. Go to Settings → API Keys
3. Create a new API key

Claude Code (.mcp.json)

Create or update .mcp.json in your project root:

{
  "mcpServers": {
    "deploybase": {
      "command": "deploybase-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "DEPLOYBASE_API_KEY": "dbk_your_api_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "deploybase": {
      "command": "deploybase-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "DEPLOYBASE_API_KEY": "dbk_your_api_key_here"
      }
    }
  }
}

Environment Variables

🚀 Usage Examples

Deploy a New Site

"Deploy my Next.js site to deploybase"

The AI agent will:

1. Validate the git repository
2. Create a new project
3. Trigger the initial deployment
4. Monitor the build status

Migrate from Vercel

"Migrate my Vercel project to deploybase"

The AI agent will:

1. Analyze your vercel.json configuration
2. Create a deploybase project with equivalent settings
3. Trigger the deployment
4. Report any manual steps needed

Manage Production

"Show me all my deploybase projects"
"Promote the previous deployment to production"
"Add www.example.com to my project"
"Get the build logs for the failed deployment"

🛠️ Available Tools

Projects

• list_projects — List all your projects
• get_project — Get detailed project configuration
• create_project — Create a new project
• update_project — Update project settings
• delete_project — Permanently delete a project
• check_subdomain — Check subdomain availability
• validate_git_repo — Validate git repository access

Deployments

• list_deployments — List deployments with filters
• get_deployment — Get deployment status and details
• get_build_logs — Retrieve build logs for debugging
• trigger_deployment — Trigger a new build
• cancel_deployment — Cancel an in-progress build
• promote_deployment — Promote to production (also for rollbacks)

Domains

• list_domains — List custom domains
• get_domain_status — Get DNS and SSL status
• add_domain — Add a custom domain
• verify_domain — Trigger DNS verification
• get_dns_instructions — Get DNS configuration instructions
• remove_domain — Remove a custom domain

Migrations

• analyze_project_config — Parse vercel.json/netlify.toml/wrangler.toml
• migrate_from_vercel — One-shot Vercel migration
• migrate_from_netlify — One-shot Netlify migration
• migrate_from_cloudflare — One-shot Cloudflare Pages migration

Team & Billing

• list_team_members — List team members
• list_team_invitations — List pending invitations
• get_billing_plan — Get subscription and usage information

Share Links

• create_share_link — Create a preview link for stakeholders
• revoke_share_link — Revoke a share link

🐳 Docker

Run as a container:

docker run -e DEPLOYBASE_API_KEY=dbk_your_key deploybase/mcp-server:latest

Or use in HTTP mode:

docker run -p 8082:8082 \
  -e TRANSPORT=http \
  -e DEPLOYBASE_API_URL=https://api.deploybase.eu \
  deploybase/mcp-server:latest

🏗️ Development

Prerequisites

• Go 1.25 or later
• A deploybase API key (for testing)

Build

make build

Run Tests

make test

Run Locally (stdio mode)

DEPLOYBASE_API_KEY=dbk_your_key make run

Run Locally (HTTP mode)

DEPLOYBASE_API_KEY=dbk_your_key make run-http

Cross-compile for All Platforms

make build-all

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

📄 License

This project is licensed under the Apache License 2.0 — see LICENSE for details.

🔗 Related Projects

• deploybase CLI — Command-line interface
• deploybase Platform — The main SaaS platform

💬 Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discord Community

🌟 Why deploybase?

Unlike most static hosting platforms:

• 🇪🇺 EU-hosted — GDPR-compliant by default
• 🔒 Privacy-first — No tracking, no analytics
• 🌍 Green hosting — Running on renewable energy
• 🚀 Developer-friendly — Git-based deployments, instant previews

Built with ❤️ in Europe