Caddy Server MCP Server for WindsurfGive Windsurf instant access to 13 tools to Adapt Config, Append Config, Delete Config, and more
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Caddy Server through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The Caddy Server MCP Server for Windsurf is a standout in the Developer Tools category — giving your AI agent 13 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
{
"mcpServers": {
"caddy-server": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Caddy Server and 4,000+ MCP Servers from a single visual interface.





* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Caddy Server MCP Server
Connect your Caddy Server instance to any AI agent and automate your web infrastructure management through natural conversation.
Windsurf's Cascade agent chains multiple Caddy Server tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 13 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
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.
The Caddy Server MCP Server exposes 13 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 13 Caddy Server tools available for Windsurf
When Windsurf connects to Caddy Server through Vinkius, your AI agent gets direct access to every tool listed below — spanning web-server, reverse-proxy, api-gateway, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Adapt config on Caddy Server
Adapts a configuration (e.g., Caddyfile) to JSON without running it
Append config on Caddy Server
and target is array, expands payload array and appends elements. Sets or replaces an object; appends to an array in Caddy config
Delete config on Caddy Server
Deletes the value at the named path in Caddy config
Get config on Caddy Server
Leave empty for full config. Exports the configuration at the specified path as JSON
Get config by id on Caddy Server
Access a configuration object directly via its @id field
Get metrics on Caddy Server
Exposes metrics in Prometheus exposition format
Get pki ca on Caddy Server
Returns information about a particular PKI app CA
Get pki ca certs on Caddy Server
Returns the certificate chain for a particular CA
Get upstreams on Caddy Server
Returns the current status of configured proxy upstreams
Insert config on Caddy Server
Creates a new object or inserts into an array at a specific index
Load config on Caddy Server
Use application/json for native JSON, or text/caddyfile for Caddyfile. Sets or replaces the active Caddy configuration
Replace config on Caddy Server
Strictly replaces an existing object or array element in Caddy config
Stop server on Caddy Server
Gracefully shuts down the Caddy server and exits the process
Connect Caddy Server to Windsurf via MCP
Follow these steps to wire Caddy Server into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using Caddy Server
Why Use Windsurf with the Caddy Server MCP Server
Windsurf provides unique advantages when paired with Caddy Server through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 13 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Caddy Server + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Caddy Server MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Caddy Server and generate models, types, or handlers based on real API responses
Live debugging: query Caddy Server tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Caddy Server and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Caddy Server data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for Caddy Server in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with Caddy Server immediately.
"Get the full JSON configuration of my Caddy server."
"Adapt this Caddyfile to JSON: 'example.com { reverse_proxy localhost:8080 }'"
"Check the status of my proxy upstreams."
Troubleshooting Caddy Server MCP Server with Windsurf
Common issues when connecting Caddy Server to Windsurf through Vinkius, and how to resolve them.
Server not connecting
Caddy Server + Windsurf FAQ
Common questions about integrating Caddy Server MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
PeerTube (YouTube Alternative)
10 toolsInteract with decentralized PeerTube instances — manage video feeds, download content, and handle user registration via AI.

Slack Webhook Notifier
1 toolsThis MCP does exactly one thing: it sends messages to your Slack channels. That's its only function, and nothing else. Zero bloat, incredible for giving your AI agents a voice.

Optum Claims & Billing
5 toolsSecurely submit medical bills, track 837 EDI claims, and process UHG bank remittance advices.

KuaiDi100
8 toolsUbiquitous logistics and package tracking platform in China — track shipments via AI.
