@deloc/mcp

MCP server for Deloc — deploy static web apps from your AI coding agent.

Say "deploy this to Deloc" in Claude Code or Cursor and get a live URL back in seconds, without leaving your editor.

Install

No install needed. The MCP server runs via npx.

Claude Code

claude mcp add deloc --scope user -- npx -y @deloc/mcp@latest

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "deloc": {
      "command": "npx",
      "args": ["-y", "@deloc/mcp@latest"]
    }
  }
}

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "deloc": {
      "command": "npx",
      "args": ["-y", "@deloc/mcp@latest"]
    }
  }
}

Pre-configured token (CI/CD)

If you have an API token from deloc.dev, pass it as an environment variable:

{
  "mcpServers": {
    "deloc": {
      "command": "npx",
      "args": ["-y", "@deloc/mcp@latest"],
      "env": {
        "DELOC_TOKEN": "dl_xxxxx"
      }
    }
  }
}

Authentication

The first time you deploy, the MCP server opens your browser to sign in with Google or Microsoft (or create an account). Your token is saved to ~/.deloc/config.json and all tools are available from then on.

You can also paste an existing API token if you registered at deloc.dev.

Usage

Just talk to your AI agent naturally:

"Deploy this to Deloc"

"Publish this dashboard to Deloc as 'Q3 Revenue'"

"Deploy this with a password"

"List my Deloc apps"

"Disable the old dashboard"

The agent calls the appropriate MCP tool and returns the result.

Tools

Deployment

| Tool | Description | |------|-------------| | deploy | Deploy or update a project. Returns a live URL. Supports directories with index.html, single JSX/TSX files, and multi-file JSX/TSX projects. Redeploying to the same name updates in place. | | suggest_deploy_options | Analyze a project directory and suggest deployment options — framework detection, build command, app name, and size estimate. |

App management

| Tool | Description | |------|-------------| | list_apps | List published apps with URLs, status, and expiry info. Filter by status. | | get_app | Get detailed info about an app — file count, size, bandwidth usage, expiry date. | | disable_app | Take an app offline without deleting it. | | enable_app | Re-enable a disabled app. | | delete_app | Permanently delete an app and all its files. | | renew_app | Extend a free-tier app's expiry by 30 days. |

Settings

| Tool | Description | |------|-------------| | set_password | Set, change, or remove password protection on an app. Auto-generates a password if none specified. | | set_og_image | Set a custom OG preview image for link previews (Slack, X, etc.). Accepts a local PNG path. |

Account

| Tool | Description | |------|-------------| | get_account | Get current user info — email, tier, storage usage, and limits. | | setup_deloc | Sign in with Google or Microsoft, or paste an API token. Shown when not yet authenticated. | | logout | Log out and clear stored credentials. |

Deploy tool details

The deploy tool handles three types of projects automatically:

Directory with index.html — zips and uploads as-is. Use ES module imports with esm.sh for CDN libraries.

Single JSX/TSX file — wraps with React, Babel, and Tailwind CSS automatically. No build step needed.

Multi-file JSX/TSX project — resolves local imports between files, bundles into a single HTML file with all dependencies. No build step needed.

Parameters

| Parameter | Type | Description | |-----------|------|-------------| | name | string | App name. Defaults to directory or package.json name. Use the same name to update an existing app. | | dir | string | Path to build output directory. Auto-detected if not specified. | | password | string | boolean | Password protect the app. Use a string for a specific password, true to auto-generate. | | public | boolean | Make app public (removes password protection). | | og_image | string | Path to a PNG for link previews. Max 2MB, 1200x630 recommended. | | og_title | string | Custom title for link previews. | | og_description | string | Custom description for link previews. |

Environment variables

| Variable | Description | Default | |----------|-------------|---------| | DELOC_TOKEN | API token for pre-configured setups | Read from ~/.deloc/config.json | | DELOC_API_URL | API endpoint | https://api.deloc.dev |

Development

This package lives in the delocdev/deloc monorepo. See the root CONTRIBUTING.md for local dev setup.

Links

• Deloc website
• @deloc/cli — CLI alternative to the MCP server
• Source on GitHub

License

MIT