@warnyin/nginx-proxy-manager-mcp

An MCP server that exposes the full Nginx Proxy Manager REST API as tools your AI assistant can call. Drop it into Claude Desktop, Claude Code, Cursor, or any MCP-compatible client and manage proxy hosts, redirections, 404 hosts, streams, SSL certificates, access lists, users, settings, audit log, and reports through natural language.

Tool surface is generated from the latest NPM swagger spec — every documented endpoint is reachable, plus an npm_request low-level escape hatch for anything obscure.

Install / Run

No global install needed. Run via npx:

npx -y @warnyin/nginx-proxy-manager-mcp

The server talks MCP over stdio — point your client at the command above with the env vars described below.

Configuration

| Env var | Required | Default | Description | | --- | --- | --- | --- | | NPM_BASE_URL | no | http://127.0.0.1:81/api | Base URL of NPM API (include /api). | | NPM_EMAIL | one of | – | Login email. Combine with NPM_PASSWORD for automatic token issuing + refresh. | | NPM_PASSWORD | one of | – | Login password. | | NPM_TOKEN | one of | – | Pre-issued JWT. Skips automatic login (will not auto-refresh once expired). |

You must provide either NPM_TOKEN or the NPM_EMAIL + NPM_PASSWORD pair.

Claude Desktop / Claude Code config

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "npx",
      "args": ["-y", "@warnyin/nginx-proxy-manager-mcp"],
      "env": {
        "NPM_BASE_URL": "http://127.0.0.1:81/api",
        "NPM_EMAIL": "[email protected]",
        "NPM_PASSWORD": "changeme"
      }
    }
  }
}

Available tools

Grouped by NPM tag — names use the <group>_<action> convention.

System

• npm_api_root — GET /
• npm_version_check — GET /version/check
• npm_schema — GET /schema
• npm_request — generic escape hatch for any path / method

Tokens

• tokens_login, tokens_refresh, tokens_validate_2fa

Users

• users_list, users_create, users_get, users_update, users_delete
• users_set_auth, users_set_permissions, users_sudo_login
• users_2fa_get, users_2fa_setup, users_2fa_enable, users_2fa_disable, users_2fa_backup_codes

Proxy hosts

• proxy_hosts_list, proxy_hosts_create, proxy_hosts_get, proxy_hosts_update, proxy_hosts_delete
• proxy_hosts_enable, proxy_hosts_disable

Redirection hosts

• redirection_hosts_list, redirection_hosts_create, redirection_hosts_get, redirection_hosts_update, redirection_hosts_delete
• redirection_hosts_enable, redirection_hosts_disable

404 hosts (dead hosts)

• dead_hosts_list, dead_hosts_create, dead_hosts_get, dead_hosts_update, dead_hosts_delete
• dead_hosts_enable, dead_hosts_disable

Streams

• streams_list, streams_create, streams_get, streams_update, streams_delete
• streams_enable, streams_disable

Certificates

• certificates_list, certificates_create, certificates_get, certificates_delete
• certificates_download, certificates_renew, certificates_upload
• certificates_validate, certificates_test_http, certificates_dns_providers

Access lists

• access_lists_list, access_lists_create, access_lists_get, access_lists_update, access_lists_delete

Audit log

• audit_log_list, audit_log_get

Reports

• reports_hosts

Settings

• settings_list, settings_get, settings_update

Local development

git clone https://github.com/warnyin/nginx-proxy-manager-mcp.git
cd nginx-proxy-manager-mcp
npm install
npm run typecheck
npm run build
node dist/index.js   # or `npm run dev` for tsx watch mode

License

MIT