Implements an MCP stdio server exposing 69 tools that cover every endpoint of the latest Nginx Proxy Manager swagger spec: - system (root, version-check, schema, low-level npm_request escape hatch) - tokens (login, refresh, 2FA validate) - users (CRUD, auth, permissions, sudo-login, full 2FA lifecycle) - proxy / redirection / dead / stream hosts (CRUD + enable/disable) - certificates (CRUD, download, renew, upload, validate, test-http, dns-providers) - access-lists (CRUD with clients + items) - audit-log (list, get) - reports (hosts) - settings (list, get, update) Auth: accepts NPM_TOKEN or auto-issues + refreshes a JWT from NPM_EMAIL/NPM_PASSWORD against NPM_BASE_URL. Distribution: npx-runnable via the @warnyin/nginx-proxy-manager-mcp scoped package; bin -> dist/index.js. Build with tsc, no runtime deps besides @modelcontextprotocol/sdk and zod.
@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": "admin@example.com",
"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/checknpm_schema—GET /schemanpm_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_deleteusers_set_auth,users_set_permissions,users_sudo_loginusers_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_deleteproxy_hosts_enable,proxy_hosts_disable
Redirection hosts
redirection_hosts_list,redirection_hosts_create,redirection_hosts_get,redirection_hosts_update,redirection_hosts_deleteredirection_hosts_enable,redirection_hosts_disable
404 hosts (dead hosts)
dead_hosts_list,dead_hosts_create,dead_hosts_get,dead_hosts_update,dead_hosts_deletedead_hosts_enable,dead_hosts_disable
Streams
streams_list,streams_create,streams_get,streams_update,streams_deletestreams_enable,streams_disable
Certificates
certificates_list,certificates_create,certificates_get,certificates_deletecertificates_download,certificates_renew,certificates_uploadcertificates_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