Nginx Proxy Manager MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "NPM_URL=${NPM_URL}" -e "NPM_EMAIL=${NPM_EMAIL}" -e "NPM_PASSWORD=${NPM_PASSWORD}" nginx-proxy-manager -- uvx nginx-proxy-manager-mcp
Required:NPM_URLNPM_EMAILNPM_PASSWORD
README.md

Manage Nginx Proxy Manager instances via Claude/AI assistants.

npm-mcp

MCP server for managing Nginx Proxy Manager (NPM) instances via Claude/AI assistants. 50 tools covering the full NPM API.

Version tracks NPM releases — v2.14.0 targets Nginx Proxy Manager v2.14.0.

Installation

# Install via uvx (recommended)
uvx nginx-proxy-manager-mcp

# Or install from source
uv sync
uv run nginx-proxy-manager-mcp

Configuration

Add to your Claude Desktop config (~/.config/claude/config.json):

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "uvx",
      "args": ["nginx-proxy-manager-mcp"],
      "env": {
        "NPM_URL": "http://your-npm-instance:81",
        "NPM_EMAIL": "admin@example.com",
        "NPM_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools (50)

Proxy Hosts (7 tools)

Tool Description Required Params
list_proxy_hosts List all proxy hosts —
get_proxy_host Get proxy host by ID host_id
create_proxy_host Create a new proxy host domain_names, forward_host, forward_port
update_proxy_host Update a proxy host host_id + any fields to change
delete_proxy_host Delete a proxy host host_id
enable_proxy_host Enable a proxy host host_id
disable_proxy_host Disable a proxy host host_id

Optional create/update params: forward_scheme, certificate_id, ssl_forced, block_exploits, advanced_config

Redirection Hosts (7 tools)

Tool Description Required Params
list_redirection_hosts List all redirection hosts —
get_redirection_host Get redirection host by ID host_id
create_redirection_host Create HTTP redirect domain_names, forward_http_code, forward_domain_name
update_redirection_host Update a redirection host host_id + any fields to change
delete_redirection_host Delete a redirection host host_id
enable_redirection_host Enable a redirection host host_id
disable_redirection_host Disable a redirection host host_id

Optional create/update params: forward_scheme (auto/http/https), preserve_path, certificate_id, ssl_forced, block_exploits, advanced_config

Streams (7 tools)

Tool Description Required Params
list_streams List all TCP/UDP streams —
get_stream Get stream by ID stream_id
create_stream Create a TCP/UDP stream proxy incoming_port, forwarding_host, forwarding_port
update_stream Update a stream stream_id + any fields to change
delete_stream Delete a stream stream_id
enable_stream Enable a stream stream_id
disable_stream Disable a stream stream_id

Optional create/update params: tcp_forwarding, udp_forwarding, certificate_id

Dead Hosts / 404 Hosts (7 tools)

Tool Description Required Params
list_dead_hosts List all 404 dead hosts —
get_dead_host Get dead host by ID host_id
create_dead_host Create a 404 dead host domain_names
update_dead_host Update a dead host host_id + any fields to change
delete_dead_host Delete a dead host host_id
enable_dead_host Enable a dead host host_id
disable_dead_host Disable a dead host host_id

Optional create/update params: certificate_id, ssl_forced, hsts_enabled, hsts_subdomains, http2_support, advanced_config

SSL Certificates (7 tools)

Tool Description Required Params
list_certificates List all SSL certificates —
get_certificate Get certificate by ID certificate_id
request_certificate Request a Let's Encrypt cert domain_names, nice_name
delete_certificate Delete a certificate certificate_id
renew_certificate Renew a Let's Encrypt cert certificate_id
list_dns_providers List supported DNS providers —
test_http_challenge Test HTTP-01 ACME reachability domains

Access Lists (5 tools)

Tool Description Required Params
list_access_lists List all access lists —
get_access_list Get access list by ID access_list_id
create_access_list Create an access list name
update_access_list Update an access list access_list_id + any fields to change
delete_access_list Delete an access list access_list_id

Optional create/update params: satisfy_any, pass_auth

Users (5 tools)

Tool Description Required Params
list_users List all NPM users —
get_user Get user by ID user_id
create_user Create a new user `

Tools (6)

list_proxy_hostsList all proxy hosts
create_proxy_hostCreate a new proxy host
list_certificatesList all SSL certificates
request_certificateRequest a Let's Encrypt cert
list_access_listsList all access lists
create_access_listCreate an access list

Environment Variables

NPM_URLrequiredThe URL of your Nginx Proxy Manager instance
NPM_EMAILrequiredThe email address for the NPM admin account
NPM_PASSWORDrequiredThe password for the NPM admin account

Configuration

claude_desktop_config.json
{"mcpServers": {"nginx-proxy-manager": {"command": "uvx", "args": ["nginx-proxy-manager-mcp"], "env": {"NPM_URL": "http://your-npm-instance:81", "NPM_EMAIL": "admin@example.com", "NPM_PASSWORD": "your-password"}}}}

Try it

→List all my current proxy hosts and their status.
→Create a new proxy host for app.example.com pointing to 192.168.1.50 on port 3000.
→Request a new Let's Encrypt SSL certificate for my domain example.com.
→Disable the proxy host with ID 5.
→List all available SSL certificates and check if any need renewal.

Frequently Asked Questions

What are the key features of Nginx Proxy Manager MCP?

Full management of Nginx Proxy Manager instances via 50+ tools.. Configure proxy hosts, redirection hosts, and TCP/UDP streams.. Automated Let's Encrypt SSL certificate requests and renewals.. Manage access lists and user accounts.. Supports advanced configuration and security settings like exploit blocking..

What can I use Nginx Proxy Manager MCP for?

Automating the deployment of new web services by creating proxy hosts via chat.. Quickly securing new domains with SSL certificates without using the web UI.. Managing complex stream configurations for TCP/UDP services.. Auditing and updating access control lists for internal applications..

How do I install Nginx Proxy Manager MCP?

Install Nginx Proxy Manager MCP by running: uvx nginx-proxy-manager-mcp

What MCP clients work with Nginx Proxy Manager MCP?

Nginx Proxy Manager MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Nginx Proxy Manager MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all cloud servers →

Related MCP Servers

SSH MCP Server
Execute shell commands on remote Linux and Windows systems via SSH.
cloud346 stars
Hono MCP Server
Expose your Hono API endpoints as MCP tools.
cloud77 stars
n8n Manager for AI Agents
Manage n8n workflow automation instances through AI agent tools.
cloud54 stars
Kilntainers
Give Every Agent an Ephemeral Linux Sandbox — via MCP
cloud36 stars
AWS MCP Server
Manage and provision AWS resources using natural language prompts
cloud27 stars
Dynamics 365 Finance & Operations
Production-ready MCP server for Microsoft Dynamics 365 Finance & Operations
cloud25 stars