PlugLayer MCP Server

Deploy and manage your infrastructure through natural language with any MCP-compatible AI assistant.

Installation

Option 1: uvx (recommended — no install needed)

PLUGLAYER_API_KEY=your-pluglayer-api-token uvx pluglayer-mcp

Optional:

PLUGLAYER_API_BASE_URL=https://api.pluglayer.com

Option 2: pip

pip install pluglayer-mcp
PLUGLAYER_API_KEY=your-pluglayer-api-token pluglayer-mcp

Configuration

Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pluglayer": {
      "command": "uvx",
      "args": ["pluglayer-mcp"],
      "env": {
        "PLUGLAYER_API_KEY": "your-pluglayer-api-token",
        "PLUGLAYER_API_BASE_URL": "https://api.pluglayer.com"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "pluglayer": {
    "command": "uvx",
    "args": ["pluglayer-mcp"],
    "env": {
      "PLUGLAYER_API_KEY": "your-pluglayer-api-token",
      "PLUGLAYER_API_BASE_URL": "https://api.pluglayer.com"
    }
  }
}

Remote HTTP (hosted)

The remote MCP server runs at mcp.pluglayer.com. Pass your token as:

Authorization: Bearer your-pluglayer-api-token

API base URL behavior

• PLUGLAYER_API_BASE_URL is the preferred environment variable for the backend API origin.

• If it is unset or empty, the MCP defaults to https://api.pluglayer.com.

• PLUGLAYER_API_URL is still accepted as a legacy fallback during migration.

Available Tools

The MCP calls the PlugLayer FastAPI backend instead of re-implementing backend business logic. Auth, roles, ownership, compute guards, k3s orchestration, and admin checks remain in the backend. MCP and editor plugins should authenticate with a PlugLayer API token created in the PlugLayer Settings page, not the browser/session auth token.

Managed registries are configured by PlugLayer admins in the platform UI/API. When deploy_image uses mirroring, the backend picks a registry the current user is allowed to use and keeps Kubernetes pull secrets in sync automatically.

Example Conversations

Deploy your first app:

"I have a FastAPI app at ghcr.io/myorg/api:latest that runs on port 8000. Deploy it to my production project."

Convert docker-compose:

"Here's my docker-compose.yml: [paste]. Deploy this to PlugLayer."

Add a node:

"Add my server at 192.168.1.100 as personal compute. Here's my SSH key: [paste]"

CI/CD setup:

"Generate a GitHub Actions workflow for my api deployment so it auto-deploys on push to main."

Add a custom domain:

"Add api.example.com to my production project, show me the DNS records, then verify it and attach it to my API app."

Getting Your API Key

1. Go to PlugLayer Settings

2. Create a PlugLayer API token

3. Copy it once and store it safely

4. Use it as PLUGLAYER_API_KEY for MCP, editor plugins, and CI/CD webhook deploys