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

Nginx Proxy Manager MCP