Which integrations are available for this server?

Provides capabilities to list existing SSL certificates and request new Let's Encrypt certificates for configured domain names. Allows for full management of Nginx Proxy Manager instances, including listing, creating, updating, and deleting proxy hosts and access lists.

How do I use Nginx Proxy Manager MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Nginx Proxy Manager MCP Create a proxy host for dev.local pointing to 192.168.1.50:3000" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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	`name`, `email`
`update_user`	Update a user	`user_id` + any fields to change
`delete_user`	Delete a user	`user_id`

Optional create/update params: nickname, roles, is_disabled

Settings (3 tools)

Tool	Description	Required Params
`list_settings`	List all NPM settings	—
`get_setting`	Get a setting by ID	`setting_id`
`update_setting`	Update a setting	`setting_id`

Optional update params: value, meta

Audit Log (1 tool)

Tool	Description	Required Params
`list_audit_log`	List recent audit log entries	—

Reports (1 tool)

Tool	Description	Required Params
`get_host_report`	Get host count report	—

Usage Examples

Once configured, use natural language:

"List all my proxy hosts"
"Create a proxy host for example.com pointing to 192.168.1.100:8080"
"Set up a 301 redirect from old.example.com to new.example.com"
"Create a TCP stream forwarding port 3306 to my database server"
"Request a Let's Encrypt certificate for api.example.com"
"Enable the proxy host with ID 5"
"Show me the audit log"

Development

uv sync --dev
uv run pytest

Requirements

Python 3.10+
Nginx Proxy Manager instance
Valid NPM credentials

License

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

Nginx Proxy Manager MCP