# Nginx Proxy Manager MCP

> Nginx Proxy Manager MCP is an open-source MCP server for cloud and infrastructure. MCP server for managing Nginx Proxy Manager hosts, certificates and streams. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux
- **Repository:** https://github.com/euisuh/nginx-proxy-manager-mcp
- **MCP Registry name:** io.github.euisuh/nginx-proxy-manager-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Every write tool takes a dry_run flag, so an assistant can show the exact HTTP request it would send to Nginx Proxy Manager before anything changes. A single call, create_proxy_host_with_letsencrypt, requests a certificate first and then creates a proxy host with HTTPS forced.

The server logs in to the NPM admin API with an admin email and password, caches the JWT in memory and re-authenticates when it gets a 401. Setting NPM_READ_ONLY=true registers only the twelve list, get and find tools, which suits an assistant that should inspect but never edit.

It runs as a local stdio process installed from PyPI, or as an SSE Docker sidecar next to an existing NPM container with the port bound to localhost by default. List tools can filter by domain substring or enabled state and return compact summaries.

## Features

- **34 typed tools:** Covers proxy hosts, redirection hosts, TCP/UDP streams, certificates, access lists and diagnostics.
- **Dry-run previews:** All mutating tools can return the method, path and JSON body without applying them.
- **One-step HTTPS host:** Requests a Let's Encrypt certificate and creates the proxy host with HTTPS forced.
- **HTTP-01 and DNS-01:** Supports wildcard certificates through DNS challenges.
- **Read-only mode:** An environment flag exposes only the twelve non-mutating tools.
- **Expiry diagnostics:** Lists certificates expiring within a chosen window and finds hosts by domain.

## Good for

- Point a new domain at a homelab container with a certificate in one request
- Audit which certificates are about to expire
- Preview reverse-proxy changes before applying them
- Manage access lists and basic-auth users from chat
- Find every host serving a given domain

## Install

### Claude Code (Terminal)

```sh
claude mcp add nginx-proxy-manager-mcp --env NPM_URL='<NPM_URL>' --env NPM_EMAIL='<NPM_EMAIL>' --env NPM_PASSWORD='<NPM_PASSWORD>' -- uvx nginx-proxy-manager-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nginx-proxy-manager-mcp": {
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "<NPM_URL>",
        "NPM_EMAIL": "<NPM_EMAIL>",
        "NPM_PASSWORD": "<NPM_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nginx-proxy-manager-mcp": {
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "<NPM_URL>",
        "NPM_EMAIL": "<NPM_EMAIL>",
        "NPM_PASSWORD": "<NPM_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nginx-proxy-manager-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "<NPM_URL>",
        "NPM_EMAIL": "<NPM_EMAIL>",
        "NPM_PASSWORD": "<NPM_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nginx-proxy-manager-mcp": {
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "<NPM_URL>",
        "NPM_EMAIL": "<NPM_EMAIL>",
        "NPM_PASSWORD": "<NPM_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nginx-proxy-manager-mcp": {
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "<NPM_URL>",
        "NPM_EMAIL": "<NPM_EMAIL>",
        "NPM_PASSWORD": "<NPM_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `list_proxy_hosts`: List proxy hosts with status.
- `get_proxy_host`: Fetch one proxy host by ID.
- `create_proxy_host`: Create a proxy host routing domains to an upstream.
- `create_proxy_host_with_letsencrypt`: Request a certificate then create an HTTPS-forced proxy host.
- `update_proxy_host`: Update settings on a proxy host.
- `delete_proxy_host`: Permanently delete a proxy host.
- `enable_proxy_host`: Enable a disabled proxy host.
- `disable_proxy_host`: Disable a proxy host while keeping its configuration.
- `list_certificates`: List SSL certificates with expiry information.
- `get_certificate`: Fetch one certificate by ID.
- `create_letsencrypt_cert`: Request a Let's Encrypt certificate over HTTP-01 or DNS-01.
- `delete_certificate`: Delete a certificate by ID.
- `renew_certificate`: Request renewal of a certificate.
- `list_access_lists`: List access lists.
- `get_access_list`: Fetch one access list.
- `create_access_list`: Create an access list with IP rules and basic-auth users.
- `update_access_list`: Update an access list.
- `delete_access_list`: Delete an access list.
- `list_redirection_hosts`: List redirection hosts.
- `get_redirection_host`: Fetch one redirection host.
- `create_redirection_host`: Create a redirect with a chosen HTTP status.
- `update_redirection_host`: Update a redirection host.
- `delete_redirection_host`: Delete a redirection host.
- `enable_redirection_host`: Enable a redirection host.
- `disable_redirection_host`: Disable a redirection host.
- `list_streams`: List TCP/UDP streams.
- `get_stream`: Fetch one stream.
- `create_stream`: Create a TCP/UDP port forward.
- `update_stream`: Update a stream.
- `delete_stream`: Delete a stream.
- `enable_stream`: Enable a stream.
- `disable_stream`: Disable a stream.
- `find_host_by_domain`: Find hosts and certificates serving a domain.
- `list_expiring_certificates`: List certificates expiring in a time window.

## FAQ

### Can it change anything without my approval?

Mutating tools accept dry_run=True to preview the request, and NPM_READ_ONLY=true removes them entirely.

### How does it authenticate?

It signs in to the NPM API with an admin email and password and keeps the JWT only in memory.

### How can I run it?

As a stdio server from the PyPI package nginx-proxy-manager-mcp-server, or as a Docker SSE sidecar next to NPM.

### Is Nginx Proxy Manager MCP free?

Yes. Nginx Proxy Manager MCP is open source, so you can use and self-host it for free.

### How do I add Nginx Proxy Manager MCP to Claude Code?

Run this command in your terminal: claude mcp add nginx-proxy-manager-mcp --env NPM_URL='<NPM_URL>' --env NPM_EMAIL='<NPM_EMAIL>' --env NPM_PASSWORD='<NPM_PASSWORD>' -- uvx nginx-proxy-manager-mcp-server

### What are the best alternatives to Nginx Proxy Manager MCP?

The closest alternatives to Nginx Proxy Manager MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/nginx-proxy-manager-mcp
