Can I use Caddy as a CLI?

Yes. KosmoKrator exposes a Caddy CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Caddy through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Caddy tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Caddy credentials stored?

Caddy credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Caddy MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Caddy CLI for Headless Automation

Use the Caddy CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 5 read 2 write Bearer token auth

Submit Caddy feedback View package source

Caddy CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Caddy CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Caddy CLI for Headless Automation
kosmokrator integrations:configure caddy --set access_token="$CADDY_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call caddy.caddy_list_sites '{"page":1,"per_page":1}' --json

Discovery Before Execution

Agents and scripts can inspect Caddy docs and schemas before choosing a function.

kosmo integrations:docs caddy --json
kosmo integrations:docs caddy.caddy_list_sites --json
kosmo integrations:schema caddy.caddy_list_sites --json
kosmo integrations:search "Caddy" --json
kosmo integrations:list --json

Useful Caddy CLI Functions

Function	Type	Parameters	Description
`caddy.caddy_list_sites`	Read	page, per_page	List all Caddy sites. Returns site IDs, domain names, status, and configuration details.
`caddy.caddy_get_site`	Read	site_id	Get detailed information about a specific Caddy site, including its configuration, domain, and status.
`caddy.caddy_create_site`	Write	name, config	Create a new site in Caddy. Specify the domain name and optional configuration parameters.
`caddy.caddy_delete_site`	Write	site_id	Delete a site from Caddy. This action is irreversible and will remove the site and its configuration.
`caddy.caddy_list_certificates`	Read	page, per_page	List all TLS certificates managed by Caddy. Returns certificate IDs, domains, expiry dates, and status.
`caddy.caddy_get_certificate`	Read	certificate_id	Get detailed information about a specific TLS certificate, including domain, issuer, validity, and SANs.
`caddy.caddy_get_current_user`	Read	none	Get details of the currently authenticated Caddy user. Returns user ID, email, username, and account info.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Caddy CLI Pages

CI Caddy CLI for CI. Cron Jobs Caddy CLI for cron jobs. Shell Scripts Caddy CLI for shell scripts. Coding Agents Caddy CLI for coding agents.