Nginx Proxy Manager MCP

Nginx Proxy Manager MCP is an MCP (Model Context Protocol) server that lets AI assistants manage a Nginx Proxy Manager instance.

  • AI
  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
Nginx Proxy Manager MCP is an MCP (Model Context Protocol) server that lets AI assistants manage a Nginx Proxy Manager instance. It exposes an HTTP endpoint on port 8000 that MCP clients such as Claude Desktop, Cursor, or any compatible agent can call to list proxy hosts, create, update, and delete hosts, manage SSL certificates, and check system health. It has no web interface of its own, and is aimed at homelab users who want to drive reverse-proxy configuration from an AI agent instead of the Nginx Proxy Manager UI.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

48/100 Fair

Maintained
79last commit 35 days ago
Popular
2516 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
701 GB minimum RAM
Security check
103 serious findings, 9 minor, CI, tests

Availability: platform listings confirmed today, links checked 19 days ago

GitHub stars
16
Open issues
1
Last commit
2026-10-16
Latest release
v0.0.7
Activity
stale

Checked 6 days ago - source: GitHub (b3nw/nginx-proxy-manager-mcp)

Resources & Compatibility

Minimum requirements: 1 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Point your templates folder to Nginx Put your own default.conf.template in a ./templates folder and mount it to /etc/nginx/templates, then set variables like MY_DOMAIN. Without this, Nginx keeps its default example config, so your domain and expected response may not work. source
  • Open the web port you expect Use a docker run flag like -p 8080:80 so your machine’s port 8080 forwards to the container’s port 80. If you don’t publish the port, browsers and apps can’t reach the site even though Nginx is running. source
  • Match workers to your CPU limit Set NGINX_ENTRYPOINT_WORKER_PROCESSES_AUTOTUNE=true if the container has a CPU limit. This makes Nginx use a safe number of workers; without it, it may assume it can use more CPUs than Docker allows. source
  • Setup and prerequisites Run Nginx Proxy Manager first and note its API endpoint (default port 81). Provide an NPM account (email and password) as environment variables; optionally set NPM_MCP_ENABLE_DESTRUCTIVE_TOOLS=true to enable create/update/delete tools and NPM_MCP_AUTH_TOKEN to require a bearer token from MCP clients. source

Fetched 47 days ago - each note links to its source

Alternatives (9)

  • BunkerWeb - BunkerWeb is a self-hosted, open-source web application firewall and NGINX-based web server that protects services with secure-by-default s…
  • Corvus - Self-hosted reverse proxy and web application firewall with a web console; it provides domain forwarding, free SSL, live traffic monitoring…
  • Fossorial Pangolin - Open-source identity-based remote access platform using WireGuard, offering unified management, tunneled connections, granular access contr…
  • Haproxy - HAProxy is a TCP proxy and a HTTP reverse proxy.
  • Nginx Proxy Manager - Nginx Proxy Manager is a self-hosted reverse proxy and web server that lets you expose home or small-office applications to the internet wi…
  • Træfik Proxy - The Cloud Native Application Proxy Simplify networking complexity while designing, deploying, and operating applications.
  • nginx-ui
  • npmplus - NPMplus is an improved fork of Nginx Proxy Manager that provides a web interface for managing reverse proxy rules, SSL certificates, and ap…
  • zoraxy - Zoraxy is a free, open-source, general-purpose reverse proxy and TCP/UDP forwarding tool for home servers and homelabs.

Checked 40 days ago - source: AlternativeTo

Common questions

Which environment variables are required for the MCP server to reach Nginx Proxy Manager?

Set NPM_API_URL to the Nginx Proxy Manager API endpoint, commonly the port 81 API path. NPM_IDENTITY and NPM_SECRET must contain the NPM account email and password.

Why can the AI assistant list hosts but not create or delete them?

Create, update, delete, enable, and disable tools are disabled by default. Set NPM_MCP_ENABLE_DESTRUCTIVE_TOOLS=true to let the server expose those write tools.

How do I protect the MCP HTTP endpoint from unauthorized clients?

Set NPM_MCP_AUTH_TOKEN to a bearer token for HTTP transport. Clients must send that token when calling the MCP server.

How do I make AI-created proxy hosts use a default SSL certificate or settings?

Set NPM_PROXY_DEFAULTS to JSON with values such as certificate_id, ssl_forced, or block_exploits. These defaults apply to create_proxy_host calls.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads