Caddy MCP Server
Manage Caddy web servers from Claude Code, Cursor, and any MCP client. 18 tools + 4 resources covering every endpoint of Caddy's admin API - config, routes, reverse proxies, TLS, PKI, metrics, snapshots. Its 15 documented tools cover caddy, route. It runs locally over stdio via the published package.
People who work with caddy and route and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-09-14 · ★ 11 · #33 OF 278 MAINTAINED API INTEGRATION · VERIFIED 2026-09-18
MIT · TypeScript servers · how we verify → /methodology
01 · Install Caddy MCP Server
before you install - you'll need
The README does not document required environment variables for a basic install.
Claude Code
claude mcp add yawlabs-caddy-mcp -- npx -y @yawlabs/caddy-mcpClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"yawlabs-caddy-mcp": {
"command": "npx",
"args": [
"-y",
"@yawlabs/caddy-mcp"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
npm package @yawlabs/caddy-mcp - published under the repo owner's npm scope (@yawlabs)
registry namespace io.github.YawLabs is GitHub-verified and matches the repo owner
03 · What Caddy MCP Server can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can read config at any JSON path (or the full config), write config at a path. Modes: overwrite (PATCH, default, idempotent), append (POST), insert (PUT, for array positions), delete config at a path. Requires confirm=true (deleting a parent path also removes every descendant), and replace the entire config atomically. 60-second timeout for cert provisioning. Auto-snapshots the prior config.
The 15 tools it gives your agent
Extracted from the project's README - what Caddy MCP Server lets an agent do.
- caddy_config_get
- - Read config at any JSON path (or the full config).
- caddy_config_set
- - Write config at a path. Modes: overwrite (PATCH, default, idempotent), append (POST), insert (PUT, for array positions).
- caddy_config_delete
- - Delete config at a path. Requires confirm=true (deleting a parent path also removes every descendant).
- caddy_config_by_id
- - Get/set/delete config by @id tag - much easier than navigating deep paths. The delete action requires confirm=true.
- caddy_load
- - Replace the entire config atomically. 60-second timeout for cert provisioning. Auto-snapshots the prior config.
- caddy_revert
- - Manage config snapshots for rollback. Actions: list, save, apply (confirm-gated). In-memory, last 10.
- caddy_reverse_proxy
- - Add a reverse proxy in one call: from='api.local' to=['localhost:3000']. Pass an optional id for idempotent writes - repeat calls replace the route in place ins
- caddy_add_route
- - Add a route with full match/handle control (any Caddy handler).
- caddy_remove_route
- - Remove a route by @id (preferred) or by index. Requires confirm=true.
- caddy_list_routes
- - Human-readable route summary. Defensive: never crashes on weird config.
- caddy_status
- - Connectivity check + config summary (server count, routes, TLS mode).
- caddy_list_servers
- - List all HTTP servers with names, addresses, route counts, and TLS status.
show all 15 tools
- caddy_upstreams
- - Reverse proxy backend health.
- caddy_pki
- - CA info and certificate chains (default CA: local).
- caddy_stop
- - Graceful shutdown. Requires confirm=true to prevent accidents.
Latest releases
v2.5.2 · 2026-09-14
Changed · @modelcontextprotocol/sdk moves from ^1.29.0 to ^1.30.0, and · npm audit is clean again (11 findings, 5 high, before). The SDK is a runtime · dependency, so the new floor reaches everyone who installs this…
v2.5.1 · 2026-09-14
Fixed · A tool call right after a config change no longer fails with "Cannot · connect to Caddy admin API … is Caddy running?" while Caddy is fine. Caddy · restarts its admin endpoint after every config load and closes…
v2.5.0 · 2026-09-14
Release tooling and documentation only; no change to the published package's · behavior. · Changed · release.sh waits for npm to actually serve a freshly published version · before the MCP Registry step. npm publish…
04 · Who maintains Caddy MCP Server
Caddy MCP Server is maintained by yawlabs. We track 12 MCP servers from yawlabs - 12 actively maintained, 77 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from yawlabs.
- ctxlint Lint AI agent context files (CLAUDE.md, AGENTS.md, etc.) against your actual codebase ★ 10
- PostgreSQL MCP Server PostgreSQL MCP server - query, schema introspection, explain, and health checks for AI assistants ★ 5
- Tailscale MCP Server Tailscale MCP server for managing your tailnet from AI assistants ★ 29
- AWS MCP Server AWS MCP server - call any AWS API from AI assistants, with first-class SSO re-login ★ 5
- MCP Compliance CLI tool and MCP server that tests MCP servers for spec compliance ★ 2
- LemonSqueezy MCP Server LemonSqueezy MCP server for managing your store from AI assistants ★ 4
05 · Facts
- repository
- github.com/yawlabs/caddy-mcp
- category
- API integration - ranked #33 of 278 actively-maintained API integration servers as of 2026-09-18.
- release cadence
- 10+ releases in the last 90 days (latest 2026-09-14)
- registry
- io.github.YawLabs/caddy-mcp (active, first published 2026-05-15 · 22 versions)
- packages
- npm:@yawlabs/caddy-mcp
06 · Caddy MCP Server FAQ
Is Caddy MCP Server still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-14 and it shipped 10+ releases in the last 90 days. We re-verify nightly.
What can Caddy MCP Server do?
With this server connected, an agent can read config at any JSON path (or the full config), write config at a path. Modes: overwrite (PATCH, default, idempotent), append (POST), insert (PUT, for array positions), delete config at a path. Requires confirm=true (deleting a parent path also removes every descendant), and replace the entire config atomically. 60-second timeout for cert provisioning. Auto-snapshots the prior config.
How do I install Caddy MCP Server?
Run `npx -y @yawlabs/caddy-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.
Does Caddy MCP Server run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Caddy MCP Server
Alternatives to Caddy MCP Server
Maintained API integration servers if Caddy MCP Server isn't the fit.
- LetsFG - Flights & Hotels Search and book flights and hotels: hundreds of airlines, plus bookable hotel rates. ★ 2,033 · 2026-09-14
- Microsoft 365 MCP Server Interact with Microsoft 365 and Office services through the Microsoft Graph API. ★ 980 · 2026-09-17
- Idea Reality MCP Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt - returns 0-100 signal. ★ 817 · 2026-08-11
- Tapo MCP MCP server for discovering and controlling TP-Link Tapo smart home devices via AI Agents ★ 803 · 2026-09-17
- Sqz Pre-injection context compression for coding agents. Zero LLM calls, zero telemetry, offline-safe. ★ 625 · 2026-09-15
- Sv Number MCP Server Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back. ★ 550 · 2026-08-10
More API integration MCP servers · Fetch MCP Server · Jobverify · You.com Web Access & AI · Atimelogger MCP · Elecz Electricity Price Signal API
More TypeScript MCP servers · Ctxlint · LemonSqueezy MCP Server · Compliance · npm Registry MCP Server · see all