How do I connect this MCP to my Caddy instance?

You need to provide the Caddy Admin API URL, such as http://localhost:2019, when you set up the connection in Vinkius.

Can I use Caddyfiles with this MCP?

Yes. You can use the adapt_config capability to convert Caddyfile text to JSON, or use load_config to apply configurations in Caddyfile format.

Does this MCP support Prometheus metrics?

Yes. The get_metrics capability exposes metrics in the Prometheus exposition format.

Can I stop my server using the agent?

Yes. The stop_server capability allows your agent to gracefully shut down the Caddy server and exit the process.

Is it safe to test configurations?

Yes. You can use adapt_config to convert Caddyfile text to JSON without actually applying those changes to your running server.

Can I use a Caddyfile instead of JSON to update my configuration?

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

How can I monitor the health of my load-balanced backends?

Use the get_upstreams capability. It returns the current status and health metrics of all configured proxy upstreams in your Caddy instance.

Is it possible to remove a specific site or route without resetting the whole server?

Absolutely. Use delete_config with the specific path (e.g., apps/http/servers/srv0/routes/1) to remove only that element from the active configuration.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Caddy Server to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Manage your reverse proxies and certificates through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 13 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 13 available through Caddy Server.

01
Delete config
This capability removes a specific value from your Caddy configuration at the path you specify.
02
Replace config
Use this to swap out an existing object or array element within your Caddy configuration.
03
Get config by ID
This capability pulls a specific configuration object using its unique @id field.
04
Get metrics
Your agent uses this to pull Prometheus-style metrics from the server.

Capability set02 / 04

05-07

3 capabilities in this set.

Part of 13 available through Caddy Server.

05
Get pki ca certs
This capability retrieves the full certificate chain for a specific CA.
06
Get upstreams
Use this to check the real-time status of your configured proxy upstreams.
07
Load config
This capability sets or replaces the active configuration using either JSON or Caddyfile formats.

Capability set03 / 04

08-10

3 capabilities in this set.

Part of 13 available through Caddy Server.

08
Stop server
This capability triggers a graceful shutdown of the Caddy process.
09
Adapt config
Your agent uses this to convert Caddyfile text into JSON without applying the changes to the live server.
10
Append config
This capability adds new elements to an existing array or sets an object in your Caddy configuration.

Capability set04 / 04

11-13

3 capabilities in this set.

Part of 13 available through Caddy Server.

11
Get config
Use this to export the configuration at a specific path as JSON.
12
Get pki ca
This capability returns detailed information about a specific PKI application CA.
13
Insert config
This capability creates a new object or places an item into an array at a specific index.

Real work

What teams actually run

Rapid Configuration Testing

Convert a Caddyfile snippet to JSON to verify the structure before applying it to production.

Real-time Health Checks

Ask your agent to check if your proxy upstreams are healthy during a deployment.

Automated Infrastructure Updates

Tell your agent to append a new route to your existing configuration.

Certificate Troubleshooting

Retrieve certificate chains to debug SSL handshake issues.

Automate a task

Put Caddy Server to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Caddy Server works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Caddy Server to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1066ms average. Fast in production.

Caddy Server is checked daily against the live service.

Daily averagePeak 1256ms

Oct 3Today

Fastest day: 899ms
Slowest day: 1256ms
14-day trend: Slowing+24%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 13 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Caddy Server, so you can see the experience inside your AI.

It does not authenticate your account with Caddy Server. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Caddy Server Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_gShVUlwT05Svndiw6yTP7MMzUZIbPaSZETyLT6Vt/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Caddy Server capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "caddy-server-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_gShVUlwT05Svndiw6yTP7MMzUZIbPaSZETyLT6Vt/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Caddy Server in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Caddy Server owners hand off.

This MCP is built for technical professionals managing web traffic and reverse proxies.

01
DevOps Engineers
They hand off infrastructure updates and backend health monitoring to the agent.
02
Web Developers
They use the agent to quickly test and adapt Caddyfile configurations during local dev.
03
SREs
They delegate the retrieval of live metrics and PKI status to ensure site reliability.

FAQ

Questions Caddy Server owners ask.

01
How do I connect this MCP to my Caddy instance?
You need to provide the Caddy Admin API URL, such as http://localhost:2019, when you set up the connection in Vinkius.
02
Can I use Caddyfiles with this MCP?
Yes. You can use the adapt_config capability to convert Caddyfile text to JSON, or use load_config to apply configurations in Caddyfile format.
03
Does this MCP support Prometheus metrics?
Yes. The get_metrics capability exposes metrics in the Prometheus exposition format.
04
Can I stop my server using the agent?
Yes. The stop_server capability allows your agent to gracefully shut down the Caddy server and exit the process.
05
Is it safe to test configurations?
Yes. You can use adapt_config to convert Caddyfile text to JSON without actually applying those changes to your running server.
06
Can I use a Caddyfile instead of JSON to update my configuration?
Yes! Use the load_config capability and set the content_type to text/caddyfile. You can also use adapt_config to preview the JSON conversion before applying it.
07
How can I monitor the health of my load-balanced backends?
Use the get_upstreams capability. It returns the current status and health metrics of all configured proxy upstreams in your Caddy instance.
08
Is it possible to remove a specific site or route without resetting the whole server?
Absolutely. Use delete_config with the specific path (e.g., apps/http/servers/srv0/routes/1) to remove only that element from the active configuration.

Explore

More in Developer Tools

Connect Caddy Server to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Delete config

Replace config

Get config by ID

Get metrics

05-07

Get pki ca certs

Get upstreams

Load config

08-10

Stop server

Adapt config

Append config

11-13

Get config

Get pki ca

Insert config

What teams actually run

Rapid Configuration Testing

Real-time Health Checks

Automated Infrastructure Updates

Certificate Troubleshooting

Building your own app? The connector is yours to use.

Caddy Server Connector

Claude Desktop

DevOps Engineers

Web Developers

SREs

How do I connect this MCP to my Caddy instance?

Can I use Caddyfiles with this MCP?

Does this MCP support Prometheus metrics?

Can I stop my server using the agent?

Is it safe to test configurations?

Can I use a Caddyfile instead of JSON to update my configuration?

How can I monitor the health of my load-balanced backends?

Is it possible to remove a specific site or route without resetting the whole server?

Hookdeck (Webhook Gateway) AI Connector

Web Scraper AI Connector

Webflow AI Connector

Webflow AI Connector

Suggestions

Browse AI AI Connector

Webshare AI Connector

Residential Proxies AI Connector

Hyperbrowser (Web Infra for AI) AI Connector