Caddy Server

Caddy Server MCP Connector for Claude

A+

Manage your Caddy web server via API — update configurations, monitor upstreams, and handle PKI certificates directly from your AI agent.

13 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your Caddy Server instance to any AI agent and automate your web infrastructure management through natural conversation.

What you can do

  • Configuration Management — Load, get, append, or replace server configurations using JSON or Caddyfile formats.
  • Caddyfile Adaptation — Instantly convert Caddyfile text into native Caddy JSON without applying the changes.
  • Upstream Monitoring — Check the real-time status and health of your proxy upstreams and backends.
  • PKI & Certificates — Inspect internal CA information and retrieve certificate chains for your managed domains.
  • Metrics & Observability — Access Prometheus-style metrics to monitor server performance and request traffic.
  • Granular Control — Delete specific configuration paths or gracefully stop the server process.

How it works

  1. Subscribe to this server
  2. Enter your Caddy Admin API URL (e.g., http://localhost:2019)
  3. Start managing your reverse proxies and web servers from Claude, Cursor, or any MCP client

Who is this for?

  • DevOps Engineers — automate infrastructure updates and monitor backend health without leaving the terminal or chat.
  • Web Developers — quickly test and adapt Caddyfile configurations during local development.
  • SREs — retrieve live metrics and PKI status to ensure site reliability and security compliance.
web-serverreverse-proxyapi-gatewayssl-certificatesautomation

13 tools expose this connector's capabilities to your AI agent.

append_config

and target is array, expands payload array and appends elements. Sets or replaces an object; appends to an array in Caddy config

delete_config

Deletes the value at the named path in Caddy config

get_config_by_id

Access a configuration object directly via its @id field

adapt_config

Adapts a configuration (e.g., Caddyfile) to JSON without running it

get_config

Leave empty for full config. Exports the configuration at the specified path as JSON

get_metrics

Exposes metrics in Prometheus exposition format

get_pki_ca_certs

Returns the certificate chain for a particular CA

get_pki_ca

Returns information about a particular PKI app CA

get_upstreams

Returns the current status of configured proxy upstreams

insert_config

Creates a new object or inserts into an array at a specific index

load_config

Use application/json for native JSON, or text/caddyfile for Caddyfile. Sets or replaces the active Caddy configuration

replace_config

Strictly replaces an existing object or array element in Caddy config

stop_server

Gracefully shuts down the Caddy server and exits the process

See how to talk to your AI agent using Caddy Server.

Get the full JSON configuration of my Caddy server.

I've retrieved the configuration. It contains 2 HTTP servers and 4 routes. Would you like me to analyze a specific path like 'apps/http'?

Adapt this Caddyfile to JSON: 'example.com { reverse_proxy localhost:8080 }'

I've adapted the Caddyfile. The resulting JSON structure defines a server for 'example.com' with a reverse proxy handler pointing to 'localhost:8080'. Shall I apply this configuration using load_config?

Check the status of my proxy upstreams.

Fetching upstream status... I found 3 configured upstreams. All backends for 'api-cluster' are currently healthy, but one node in 'static-assets' is reporting a timeout. Would you like the full metrics?

Yes! Use the `load_config` tool and set the `content_type` to `text/caddyfile`. You can also use `adapt_config` to preview the JSON conversion before applying it.

Related Connectors