Connection check
local install
caddy-mcp
MCP server for managing Caddy web servers via the admin API
Tools
18
GitHub stars
—
Installs / wk
802
Licence
—
Transport
stdio
Last checked
never
Tools & capabilities
18 toolsRead from the published package source — this server runs locally, so there is no endpoint to query. Names are taken from the code, not observed at runtime, and descriptions are often absent.
caddy_adapt
from source
Convert a config in any registered adapter format to Caddy JSON without loading it. Useful for previewing what a Caddyfile produces, or for porting from nginx/yaml configs when Cad… Convert a config in any registered adapter format to Caddy JSON without loading it. Useful for previewing what a Caddyfile produces, or for porting from nginx/yaml configs when Caddy is built with the matching adapter module (
caddy_add_route
from source
Add a route with full control over match conditions and handlers. Supports any Caddy handler (reverse_proxy, file_server, static_response, redirect, encode, headers, etc.). Add a route with full control over match conditions and handlers. Supports any Caddy handler (reverse_proxy, file_server, static_response, redirect, encode, headers, etc.).
caddy_config_by_id
from source
Access config by @id tag. Any config object with an Access config by @id tag. Any config object with an
caddy_config_delete
from source
Delete config at a JSON path. Removes the config node at the specified path. Deleting a parent node also deletes every descendant -- e.g. deleting Delete config at a JSON path. Removes the config node at the specified path. Deleting a parent node also deletes every descendant -- e.g. deleting
caddy_config_get
from source
Read Caddy config at any JSON path. Returns the full config when path is empty, or a subtree at a specific path (e.g., Read Caddy config at any JSON path. Returns the full config when path is empty, or a subtree at a specific path (e.g.,
caddy_config_set
from source
Write config at a JSON path. Mode Write config at a JSON path. Mode
caddy_list_routes
from source
List all routes on a Caddy HTTP server with a human-readable summary of matchers and handlers, followed by the raw route JSON. Both halves are capped on large servers: the summary… List all routes on a Caddy HTTP server with a human-readable summary of matchers and handlers, followed by the raw route JSON. Both halves are capped on large servers: the summary at 500 routes, the JSON at 20000 characters (truncated on whole-route boundaries, so it always parses). When either cap trims output, a note says how many routes were omitted -- read the rest with caddy_config_get at
caddy_list_servers
from source
List all configured HTTP servers with their names, listen addresses, route counts, and TLS status. Use this to discover server names before calling route tools. List all configured HTTP servers with their names, listen addresses, route counts, and TLS status. Use this to discover server names before calling route tools.
caddy_load
from source
Replace the entire Caddy configuration atomically. Accepts a JSON config object, or a Caddyfile string with format= Replace the entire Caddy configuration atomically. Accepts a JSON config object, or a Caddyfile string with format=
caddy_metrics
from source
Get Prometheus metrics from Caddy. Shows request counts, durations, TLS handshake stats, active connections, and more. Output can be megabytes on busy servers -- use Get Prometheus metrics from Caddy. Shows request counts, durations, TLS handshake stats, active connections, and more. Output can be megabytes on busy servers -- use
caddy_pki
from source
Get PKI certificate authority info or the CA certificate chain. Get PKI certificate authority info or the CA certificate chain.
caddy_remove_route
from source
caddy_reverse_proxy
from source
Add a reverse proxy route. The most common operation \u2014 just specify where traffic comes from and where it goes. Example: from= Add a reverse proxy route. The most common operation \u2014 just specify where traffic comes from and where it goes. Example: from=
caddy_revert
from source
Manage config snapshots for rollback. Snapshots are auto-captured before caddy_load (last 10). By default they live in memory only and are LOST when this server restarts -- set CAD… Manage config snapshots for rollback. Snapshots are auto-captured before caddy_load (last 10). By default they live in memory only and are LOST when this server restarts -- set CADDY_MCP_SNAPSHOT_DIR to a writable directory to persist them across restarts (they contain full Caddy configs, so pick the location deliberately). Actions:
caddy_status
from source
Check Caddy connectivity and get a config summary: servers, routes, listen addresses, and TLS status. Check Caddy connectivity and get a config summary: servers, routes, listen addresses, and TLS status.
caddy_stop
from source
Gracefully shut down the Caddy server. Requires confirm=true to prevent accidental shutdown. Gracefully shut down the Caddy server. Requires confirm=true to prevent accidental shutdown.
caddy_tls
from source
Get or configure TLS/HTTPS settings. Actions: Get or configure TLS/HTTPS settings. Actions:
caddy_upstreams
from source