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 Shell Scripts

Use the Caddy CLI for shell scripts 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 Shell Scripts

Call integration functions from shell scripts with stable JSON input and output.

Use shell scripts for small local automations that need one or more integration calls. 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 Shell Scripts
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. Headless Automation Caddy CLI for headless automation. Coding Agents Caddy CLI for coding agents.