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 MCP, CLI, and Lua Integration for AI Agents

Caddy integration docs for AI agents: MCP gateway setup, Caddy CLI commands, Lua API reference, credentials, and function schemas.

7 functions 5 read 2 write Bearer token auth

Submit Caddy feedback View package source

Caddy for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: caddy
route_slug: caddy
package: caddy
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Caddy CLIHeadless setup and direct function calls. Caddy MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Caddy MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Caddy.

Claude Code Caddy MCP setup for Claude Code. Cursor Caddy MCP setup for Cursor. Codex Caddy MCP setup for Codex. OpenAI Agents Caddy MCP setup for OpenAI Agents SDK. Claude Agent SDK Caddy MCP setup for Claude Agent SDK. Vercel AI SDK Caddy MCP setup for Vercel AI SDK. LangChain Caddy MCP setup for LangChain. LangGraph Caddy MCP setup for LangGraph. CrewAI Caddy MCP setup for CrewAI. MCP clients Caddy MCP setup for Generic MCP Clients.

Caddy CLI Matrix

Use these pages for direct Caddy CLI workflows in scripts, CI, cron, and agent wrappers.

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

Function Catalog

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