Skip to content
MCP server

Nginx Proxy Manager MCP

MCP server for managing Nginx Proxy Manager hosts, certificates and streams

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.5.2
Listing updated
today

Similar MCP servers

About Nginx Proxy Manager MCP

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

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NPM_URLBase URL of the Nginx Proxy Manager admin APIRequired
  • NPM_EMAILExisting NPM admin emailRequired
  • NPM_PASSWORDExisting NPM admin passwordRequired
  • MCP_TRANSPORTMust be stdio when launched by an MCP client

Tools this server provides (34)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Nginx Proxy Manager MCP 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.

How AIPoweredBot checks servers