KosmoKrator

productivity

Caddy MCP Integration for LangGraph

Connect Caddy to LangGraph through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write Bearer token auth
Submit Caddy feedback View package source

Connect Caddy to LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Caddy MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "mcpServers": {
    "kosmokrator-caddy": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=caddy",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=caddy --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Caddy instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Caddy Tools Visible to LangGraph

LangGraph sees stable MCP tool names generated from the Caddy integration catalog.

MCP toolSource functionTypeDescription
integration__caddy__caddy_list_sites caddy.caddy_list_sites Read List all Caddy sites. Returns site IDs, domain names, status, and configuration details.
integration__caddy__caddy_get_site caddy.caddy_get_site Read Get detailed information about a specific Caddy site, including its configuration, domain, and status.
integration__caddy__caddy_create_site caddy.caddy_create_site Write Create a new site in Caddy. Specify the domain name and optional configuration parameters.
integration__caddy__caddy_delete_site caddy.caddy_delete_site Write Delete a site from Caddy. This action is irreversible and will remove the site and its configuration.
integration__caddy__caddy_list_certificates caddy.caddy_list_certificates Read List all TLS certificates managed by Caddy. Returns certificate IDs, domains, expiry dates, and status.
integration__caddy__caddy_get_certificate caddy.caddy_get_certificate Read Get detailed information about a specific TLS certificate, including domain, issuer, validity, and SANs.
integration__caddy__caddy_get_current_user caddy.caddy_get_current_user Read Get details of the currently authenticated Caddy user. Returns user ID, email, username, and account info.

Related Caddy Pages

Caddy CLIUse direct JSON commands instead of MCP discovery. Caddy MCPFull gateway reference and MCP tool names. KosmoKrator for LangGraphClient-level gateway setup.