Skip to main content
Glama
Nginx Proxy Manager MCP

Nginx Proxy Manager MCP

Nginx Proxy Manager MCP

CI Docker Python Package PyPI License: MIT Glama MCP server

An MCP server for Nginx Proxy Manager. It lets Claude and other MCP clients manage proxy hosts, redirection hosts, TCP/UDP streams, Let's Encrypt certificates, and access lists through typed tools instead of clicking through the NPM admin UI.

"Point blog.example.com at the container on port 3000 with HTTPS"
      │
      ▼
Claude / MCP client ──► Nginx Proxy Manager MCP ──HTTP + JWT──► NPM API

Dry-run preview of creating an HTTPS proxy host

The demo calls create_proxy_host_with_letsencrypt(dry_run=True) against a mocked NPM API and prints both request previews. No real NPM instance or credentials are used. To record it again, install the development dependencies and VHS, then run vhs docs/demo.tape from the repository root; docs/demo.py uses the same respx mocking approach as the tests.

Why this exists

Reverse-proxy changes are repetitive homelab work: create a host, point it at a container, attach a certificate, maybe restrict it to an access list. That is exactly the kind of operational task an AI assistant can handle well when it has narrow, typed tools and a local admin boundary.

This server runs either:

  • as an SSE Docker sidecar next to an existing NPM container, or

  • as a stdio MCP server for local clients.

Related MCP server: MCP Manager

Features

  • 34 MCP tools for common NPM operations (table below).

  • dry_run on all mutating tools to preview NPM requests before applying them.

  • One-shot create_proxy_host_with_letsencrypt requests a certificate, then creates an HTTPS-forced proxy host.

  • Let's Encrypt over HTTP-01 or DNS-01 (wildcards), with the request shape picked from the NPM version reported by GET /api/.

  • NPM_READ_ONLY=true registers only the 12 list_/get_/find_ tools.

  • JWT auth against the NPM API with in-memory token caching and automatic re-authentication on 401.

  • Docker sidecar deployment that binds the MCP port to localhost by default.

  • Offline pytest suite with mocked NPM API responses, including end-to-end calls through the MCP protocol layer; CI runs it on Python 3.10–3.13.

  • Ruff quality gate and contributor templates for public maintenance.

  • Python wheel build validation and MCP directory metadata for promotion readiness.

  • No token persistence and no hardcoded credentials.

Tools

Tool

Category

Read-only

Description

list_proxy_hosts

Proxy hosts

yes

List proxy hosts configured in NPM, including their current status.

get_proxy_host

Proxy hosts

yes

Fetch one proxy host by ID, including its configured fields and current status.

create_proxy_host

Proxy hosts

Create a proxy host that routes the supplied domains to an HTTP or HTTPS upstream.

create_proxy_host_with_letsencrypt

Proxy hosts

Request a Let's Encrypt certificate, then create a proxy host using that certificate with HTTPS forced.

update_proxy_host

Proxy hosts

Update writable settings on an existing proxy host by ID.

delete_proxy_host

Proxy hosts

Permanently delete a proxy host by ID, removing its configured domain routing from NPM.

enable_proxy_host

Proxy hosts

Enable a disabled proxy host by ID so NPM serves its configured domain routing again.

disable_proxy_host

Proxy hosts

Disable a proxy host by ID while retaining its configuration.

list_certificates

Certificates

yes

List SSL certificates known to NPM, including expiry information when provided by NPM.

get_certificate

Certificates

yes

Fetch one certificate by ID, including provider, domain names, expiry and meta.

create_letsencrypt_cert

Certificates

Request a new Let's Encrypt certificate for the supplied domains, over HTTP-01 by default or DNS-01 with dns_challenge=True (required for wildcards).

delete_certificate

Certificates

Permanently delete a certificate by ID, for example one left behind when create_proxy_host_with_letsencrypt fails at the proxy step.

renew_certificate

Certificates

Request renewal of an existing certificate by ID.

list_access_lists

Access lists

yes

List access lists configured in NPM.

get_access_list

Access lists

yes

Fetch one access list by ID, including its client rules and basic-auth user metadata.

create_access_list

Access lists

Create an access list containing optional IP allow/deny rules and basic-auth users.

update_access_list

Access lists

Update writable fields on an existing access list by ID, including client rules and basic-auth users.

delete_access_list

Access lists

Permanently delete an access list by ID from NPM.

list_redirection_hosts

Redirection hosts

yes

List configured redirection hosts and their current status.

get_redirection_host

Redirection hosts

yes

Fetch one redirection host by ID with its configured destination and status.

create_redirection_host

Redirection hosts

Create a host that redirects requests for domains to a destination using the selected HTTP status.

update_redirection_host

Redirection hosts

Update writable settings on an existing redirection host by ID.

delete_redirection_host

Redirection hosts

Permanently delete a redirection host by ID, removing its redirect configuration from NPM.

enable_redirection_host

Redirection hosts

Enable a disabled redirection host by ID so NPM serves its redirect again.

disable_redirection_host

Redirection hosts

Disable a redirection host by ID while keeping its configuration in NPM.

list_streams

Streams

yes

List configured TCP/UDP streams and their current status.

get_stream

Streams

yes

Fetch one TCP/UDP stream by ID, including its forwarding ports and protocol settings.

create_stream

Streams

Create a TCP/UDP port forward from an incoming port to a destination host and port.

update_stream

Streams

Update writable port, destination, or protocol fields on an existing stream by ID.

delete_stream

Streams

Permanently delete a TCP/UDP stream by ID; NPM stops forwarding that port immediately and this cannot be undone.

enable_stream

Streams

Enable a disabled TCP/UDP stream by ID so NPM forwards its incoming port again.

disable_stream

Streams

Disable a TCP/UDP stream by ID while retaining its forwarding configuration.

find_host_by_domain

Diagnostics

yes

Find proxy hosts, redirection hosts, and certificates serving a domain using exact or wildcard matching.

list_expiring_certificates

Diagnostics

yes

List certificates expiring within the requested UTC time window, including certificates already expired, sorted by expiry.

The table is generated by docs/tools_table.py from the registered tools; tests/test_readme.py fails if it drifts. Read-only tools are the ones NPM_READ_ONLY keeps.

List tools support optional server-side filtering after fetching from NPM: domain matches a case-insensitive substring in any domain name for proxy hosts, redirection hosts, and certificates; enabled filters proxy hosts, redirection hosts, and streams by status. All four accept compact=True to return only summary fields. Filters combine, and calls without arguments return the full, unchanged NPM list. For example, list_proxy_hosts(domain="example", enabled=True, compact=True) lists enabled hosts matching "example" with compact output.

All mutating tools expose dry_run=True. Previews contain method and path, plus json when the request has a body; the HTTPS workflow returns two previews in steps. The flag suppresses mutating requests, though some previews read current state. Update tools send only the fields in NPM's PUT schema (fixes #19); this is covered by mocked tests and not yet checked against a live NPM instance.

Compared to other NPM MCP servers

Competitor facts below come only from their linked READMEs fetched with gh api repos/<owner>/nginx-proxy-manager-mcp/readme on 2026-10-13. “not documented” means the README does not establish the capability, not that it is absent. Auth guard means inbound MCP client authentication, distinct from NPM API login.

Repository

Tool count documented

Dry-run support

Transport

Auth guard

euisuh (this server)

34

dry_run on all mutating tools

stdio, SSE

Optional SSE bearer token (MCP_BEARER_TOKEN); /healthz exempt

b3nw

14 named tools (13 catalog rows plus list_instances)

not documented

stdio, HTTP

HTTP bearer token (NPM_MCP_AUTH_TOKEN)

omichelbraga

66

DELETE without confirm: true previews affected resources; general dry_run not documented

stdio, Streamable HTTP

Optional bearer token (NPM_MCP_BEARER_TOKEN); unset means no inbound auth

drmogie

4 named tools (npm_status, npm_hosts, npm_audit_log, npm_call)

Changes show what will be sent and require confirm; dry_run not documented

not documented

not documented

This server's implementations expose dry_run on every mutating tool, provide the one-shot create_proxy_host_with_letsencrypt workflow, and publish the Docker sidecar at 127.0.0.1:8000:8000. These are verified in tools/, server.py, and docker-compose.yml. They do not establish that other servers lack equivalent capabilities.

Quick start: Docker sidecar

The bundled docker-compose.yml starts both Nginx Proxy Manager and this MCP sidecar from source. If you already run NPM, copy only the nginx-proxy-manager-mcp service into your existing compose file.

git clone https://github.com/euisuh/nginx-proxy-manager-mcp.git
cd nginx-proxy-manager-mcp
cp .env.example .env
# edit .env — NPM_EMAIL / NPM_PASSWORD of an existing NPM user (a dedicated non-admin user works; see Security)
docker compose up -d

NPM_URL defaults to http://app:81, the NPM admin API on the internal Docker network. Leave it as-is when both services share a compose stack; point it at your NPM host otherwise.

To use the published GHCR image instead of building locally:

services:
  nginx-proxy-manager-mcp:
    image: ghcr.io/euisuh/nginx-proxy-manager-mcp:latest
    restart: unless-stopped
    environment:
      NPM_URL: http://app:81
      NPM_EMAIL: ${NPM_EMAIL}
      NPM_PASSWORD: ${NPM_PASSWORD}
      MCP_TRANSPORT: sse
      MCP_HOST: 0.0.0.0
      MCP_PORT: 8000
      MCP_BEARER_TOKEN: ${MCP_BEARER_TOKEN:-}
    ports:
      - "127.0.0.1:8000:8000"

Register the SSE server with Claude Code (without --transport sse, claude mcp add treats the URL as a command to run):

claude mcp add --transport sse npm http://localhost:8000/sse
# with MCP_BEARER_TOKEN set:
claude mcp add --transport sse npm http://localhost:8000/sse -H "Authorization: Bearer YOUR_TOKEN"

Or add it manually to an MCP client config:

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "url": "http://localhost:8000/sse"
    }
  }
}

More examples live in examples/: Claude Desktop, Claude Code, Cursor, and Windsurf.

Quick start: uvx / pipx

If you do not want Docker, run it from PyPI (package nginx-proxy-manager-mcp-server):

NPM_URL=http://localhost:81 \
NPM_EMAIL=admin@example.com \
NPM_PASSWORD=... \
MCP_TRANSPORT=stdio \
uvx nginx-proxy-manager-mcp-server

Or from a local checkout:

git clone https://github.com/euisuh/nginx-proxy-manager-mcp.git
cd nginx-proxy-manager-mcp

NPM_URL=http://localhost:81 \
NPM_EMAIL=admin@example.com \
NPM_PASSWORD=... \
MCP_TRANSPORT=stdio \
uvx --from . nginx-proxy-manager-mcp

Or install it into an isolated environment:

pipx install nginx-proxy-manager-mcp-server

The published 0.6.0 wheel requires Python 3.12+; the source supports Python 3.10+.

Claude Desktop (claude_desktop_config.json) launching it with uvx:

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "uvx",
      "args": ["nginx-proxy-manager-mcp-server"],
      "env": {
        "NPM_URL": "http://localhost:81",
        "NPM_EMAIL": "mcp@example.com",
        "NPM_PASSWORD": "...",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Claude Code, same launch:

claude mcp add npm \
  -e NPM_URL=http://localhost:81 -e NPM_EMAIL=mcp@example.com -e NPM_PASSWORD=... \
  -e MCP_TRANSPORT=stdio \
  -- uvx nginx-proxy-manager-mcp-server

To check a launch without touching NPM, list tools: tool listing makes no NPM request, and NPM is contacted on the first tool call.

Quick start: stdio

Use stdio when you want the MCP client to launch the server process directly instead of talking to a sidecar.

python -m venv .venv
. .venv/bin/activate
pip install -e .
NPM_URL=http://localhost:81 \
NPM_EMAIL=admin@example.com \
NPM_PASSWORD=... \
MCP_TRANSPORT=stdio \
nginx-proxy-manager-mcp

Example client config:

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "/path/to/nginx-proxy-manager-mcp/.venv/bin/python",
      "args": ["-m", "nginx_proxy_manager_mcp.server"],
      "env": {
        "NPM_URL": "http://localhost:81",
        "NPM_EMAIL": "admin@example.com",
        "NPM_PASSWORD": "...",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Configuration

Variable

Required

Default

Description

NPM_URL

yes

—

Base URL of the NPM admin API (http://app:81 inside Docker)

NPM_EMAIL

yes

—

Email of the NPM user the server logs in as (see NPM credential scope)

NPM_PASSWORD

yes

—

That user's password

NPM_READ_ONLY

no

disabled

1, true, or yes (case-insensitive) registers only list_, get_, and find_ tools; all other values disable read-only mode

MCP_TRANSPORT

no

sse

MCP transport: sse or stdio

MCP_HOST

no

127.0.0.1

Bind address for SSE mode; Docker Compose sets 0.0.0.0 inside the container while publishing only to localhost

MCP_PORT

no

8000

Bind port for SSE mode

MCP_BEARER_TOKEN

no

—

Optional bearer token required for SSE HTTP requests

Set NPM_READ_ONLY=true to expose only read-only tools.

Missing required variables make the server exit with a clear error at startup rather than fail on the first API call.

SSE mode also exposes GET /healthz, an unauthenticated liveness endpoint that returns a small JSON response. It does not contact NPM or validate credentials; use it for container and reverse-proxy health checks only.

NPM compatibility

Request bodies follow the JSON schemas in NPM's backend/schema/ and were checked against tags v2.12.6, v2.13.0, and v2.16.0. NPM rejects unknown fields (additionalProperties: false), so version differences matter:

  • NPM 2.13.0 removed meta.letsencrypt_email and meta.letsencrypt_agree and uses the NPM user's account email for Let's Encrypt. The server reads the version once from the unauthenticated GET /api/ and only sends those fields to NPM older than 2.13; there, email is required.

  • Update tools send only the fields in NPM's PUT schema (see #19).

These checks are against schema files and mocked tests, not a live NPM instance.

Architecture

┌───────────────┐   MCP over SSE/stdio   ┌──────────────────────────┐
│ Claude/Cursor │ ─────────────────────► │ Nginx Proxy Manager MCP  │
│ / MCP client  │                        │ server.py + tools/       │
└───────────────┘                         └───────────┬──────────────┘
                                                       │ HTTP + Bearer JWT
                                                       ▼
                                           ┌──────────────────────────┐
                                           │ Nginx Proxy Manager API  │
                                           │ app:81 / localhost:81    │
                                           └──────────────────────────┘
  • nginx_proxy_manager_mcp/server.py validates required env vars, builds the FastMCP app, registers every tool module, and serves either SSE or stdio.

  • nginx_proxy_manager_mcp/npm_client.py wraps httpx, exchanges the email/password for a JWT on first use, caches the token in memory, and re-authenticates once on 401. NPM errors become NPMAPIError with NPM's own message; transport failures become NPMConnectionError naming NPM_URL.

  • nginx_proxy_manager_mcp/tools/ keeps one module per NPM resource. Adding a resource means adding one register_*_tools(mcp, client) function and one registration line.

Development

python -m venv .venv
. .venv/bin/activate
pip install -e . -r requirements-dev.txt
pytest -q

Tests mock the NPM API with respx, so the suite runs offline and touches no real infrastructure. CI runs the same command on every push and pull request.

Releases

Tagged releases (vX.Y.Z) publish the nginx-proxy-manager-mcp-server package to PyPI via trusted publishing (.github/workflows/publish.yml) and multi-architecture Docker images to GitHub Container Registry:

  • ghcr.io/euisuh/nginx-proxy-manager-mcp:<version> for tags such as v0.2.0

  • ghcr.io/euisuh/nginx-proxy-manager-mcp:<major>.<minor> for semver tags

  • ghcr.io/euisuh/nginx-proxy-manager-mcp:latest for the newest tagged release

The Docker workflow also builds pull requests without pushing an image, so packaging changes are validated before release.

Security

Anything that can reach this MCP server has the NPM permissions of the account in NPM_EMAIL, so it can change proxy hosts and certificates.

NPM credential scope

The server needs no NPM admin rights. It only calls /api/tokens, /api/nginx/*, and the unauthenticated GET /api/. It never touches users, settings, or the audit log. Create a dedicated NPM user (Users → Add User) instead of reusing your admin login:

  • Permissions are per resource: proxy hosts, redirection hosts, streams, access lists, and certificates, each manage, view, or hidden (NPM permission-object.json). Grant manage only where the assistant should make changes.

  • Item visibility all lets the user see hosts created by others; user limits it to items it created.

  • For an inspect-only setup, pair a view-only NPM user with NPM_READ_ONLY=true. NPM enforces the first and the server enforces the second.

  • On NPM 2.13+, Let's Encrypt registers with this user's email, so give it a real address.

Deployment

  • Do not expose the MCP endpoint publicly.

  • Keep the Docker port bound to 127.0.0.1 unless you have another trusted network boundary.

  • Bare SSE runs bind to 127.0.0.1 by default; set MCP_HOST=0.0.0.0 only behind a trusted network boundary.

  • Set MCP_BEARER_TOKEN for SSE deployments that can be reached by anything beyond the local machine, and configure clients to send Authorization: Bearer YOUR_TOKEN.

  • Use environment variables or a secrets manager for NPM credentials; do not commit .env.

  • The NPM JWT lives in process memory, is sent only in the Authorization header, and is never logged or written to disk. Error messages carry NPM's error text and URL, not request headers or bodies.

  • create_letsencrypt_cert with DNS-01 takes the DNS provider credentials as a tool argument, so they appear in the MCP client's transcript. NPM never returns them, and dry-run previews show <redacted>.

  • get_access_list drops NPM's password hint field, which reveals the first character and length of each basic-auth password.

  • The container runs as a non-root user.

See SECURITY.md for reporting and deployment guidance.

Roadmap

See ROADMAP.md. Near-term priorities are broader NPM resource coverage and operational hardening.

Listings

Directory metadata lives in server.json (MCP Registry), glama.json (Glama maintainer verification) and smithery.yaml (stdio launch config for Smithery-style directories).

Limitations

  • Covers proxy hosts, redirection hosts, streams, certificates, and access lists only. 404 hosts, users, audit log, and settings are not implemented.

  • Certificates: Let's Encrypt (HTTP-01, or DNS-01 via a certbot DNS plugin NPM knows). No custom certificate upload or download.

  • update_access_list replaces basic-auth users wholesale when items is given, and each item needs its password (NPM cannot return stored passwords).

  • Integration tests against a live NPM container (CI, NPM 2.16.0) cover only the version probe and proxy-host create/list/delete. Other request shapes are checked against NPM's schema files and mocked tests.

  • One NPM instance per server process; there is no multi-tenant or multi-host routing.

  • Optional SSE bearer-token auth protects the HTTP endpoint, but there is no per-tool authorization after a client is authenticated.

  • /healthz reports only process liveness, not NPM reachability.

  • Written against the NPM v2 API; older or forked NPM builds may differ.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md. Adding a new NPM resource follows a fixed shape:

  1. Create nginx_proxy_manager_mcp/tools/<resource>.py with a register_<resource>_tools(mcp, client) function.

  2. Register it in register_all() in nginx_proxy_manager_mcp/server.py.

  3. Add tests/test_<resource>.py covering each tool with respx-mocked NPM responses.

  4. Regenerate the README tool table with python docs/tools_table.py.

  5. Run ruff check . and pytest -q.

Commits follow Conventional Commits.

Author

Built and maintained by Euisuh Jeong to manage a homelab reverse proxy from Claude Code.

License

MIT — see LICENSE.

Available Tools

32 tools
create_access_listCreate Access ListA

Create an access list containing optional IP allow/deny rules and basic-auth users. Use this to define access controls for hosts; use update_access_list to change an existing list. NPM stores the rules and credentials, while item passwords are write-only and cannot be read back. Returns the created list object with its ID, name, and rules. Set dry_run=True to preview the exact request without changing NPM.

Inputs: name (required), items, clients, dry_run, +2 more. Returns: object

create_letsencrypt_certCreate Letsencrypt CertA

Request a new Let's Encrypt certificate for the supplied domains. Use this when a certificate is needed without creating a proxy host; create_proxy_host_with_letsencrypt also creates an HTTPS-forced host. This sends a certificate request to NPM and may contact Let's Encrypt. Returns the certificate object with its ID, domains, and status. Set dry_run=True to preview the exact request without changing NPM.

Inputs: email (required), domain_names (required), dry_run, dns_challenge. Returns: object

create_proxy_hostCreate Proxy HostA

Create a proxy host that routes the supplied domains to an HTTP or HTTPS upstream. Use this when configuring proxying without requesting a certificate; use create_proxy_host_with_letsencrypt to request one and force HTTPS. NPM stores the host configuration and applies it through its normal config handling. Returns the created host object with its ID, domains, and forwarding settings. Set dry_run=True to preview the exact request without changing NPM.

Inputs: domain_names (required), forward_host (required), forward_port (required), forward_scheme (required), +7 more. Returns: object

create_proxy_host_with_letsencryptCreate Proxy Host With LetsencryptA

Request a Let's Encrypt certificate, then create a proxy host using that certificate with HTTPS forced. Use this for a new TLS-enabled proxy; use create_proxy_host when a certificate already exists or HTTPS forcing is not wanted. This triggers a certificate request before creating the host; failures report failed_step and any created certificate. Returns ok plus certificate and proxy_host objects on success. Set dry_run=True to preview the exact request without changing NPM.

Inputs: email (required), domain_names (required), forward_host (required), forward_port (required), +6 more. Returns: object

create_redirection_hostCreate Redirection HostA

Create a host that redirects requests for domains to a destination using the selected HTTP status. Use this for URL redirection; use create_proxy_host to forward requests to an upstream server. NPM stores the redirect configuration; an attached certificate ID is referenced without requesting a certificate. Returns the created host object with its ID and redirect settings. Set dry_run=True to preview the exact request without changing NPM.

Inputs: domain_names (required), forward_domain_name (required), dry_run, ssl_forced, +5 more. Returns: object

create_streamCreate StreamA

Create a TCP/UDP port forward from an incoming port to a destination host and port. Use this for raw TCP or UDP forwarding; use proxy-host tools for HTTP/HTTPS domain routing. NPM stores the stream configuration and applies it through normal config handling. Returns the created stream object with its ID, ports, and protocol flags. Set dry_run=True to preview the exact request without changing NPM.

Inputs: incoming_port (required), forwarding_host (required), forwarding_port (required), dry_run, +2 more. Returns: object

delete_access_listDelete Access ListA

Permanently delete an access list by ID from NPM. Use update_access_list to retain the list and change its rules; confirm the ID with list_access_lists first. Deletion cannot be undone and may affect hosts that reference the list. Returns True on success. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: result

delete_proxy_hostDelete Proxy HostA

Permanently delete a proxy host by ID, removing its configured domain routing from NPM. Use disable_proxy_host to stop routing while keeping the host; list_proxy_hosts helps confirm the ID. Deletion cannot be undone and NPM applies the configuration change. Returns True on success. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: result

delete_redirection_hostDelete Redirection HostA

Permanently delete a redirection host by ID, removing its redirect configuration from NPM. Use disable_redirection_host to retain it while stopping redirects; list_redirection_hosts helps verify the ID. Deletion cannot be undone and applies the NPM configuration change. Returns True on success. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: result

delete_streamDelete StreamA

Permanently delete a TCP/UDP stream by ID; NPM stops forwarding that port immediately and this cannot be undone. List streams first to confirm the ID. Returns True on success. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: result

disable_proxy_hostDisable Proxy HostA

Disable a proxy host by ID while retaining its configuration. Use delete_proxy_host to remove it; use list_proxy_hosts to check its current status. This changes NPM host state and stops that host from serving traffic. Returns the updated host object. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

disable_redirection_hostDisable Redirection HostA

Disable a redirection host by ID while keeping its configuration in NPM. Use delete_redirection_host to remove it; use list_redirection_hosts to check status. This stops the redirect from being served and applies the configuration change. Returns the updated host object. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

disable_streamDisable StreamA

Disable a TCP/UDP stream by ID while retaining its forwarding configuration. Use delete_stream to remove it; list_streams shows current status. NPM stops forwarding this stream while disabled. Returns the updated stream object. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

enable_proxy_hostEnable Proxy HostA

Enable a disabled proxy host by ID so NPM serves its configured domain routing again. Use update_proxy_host to change host settings; use list_proxy_hosts to confirm status and ID. This changes NPM host state and applies its configuration. Returns the updated host object. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

enable_redirection_hostEnable Redirection HostA

Enable a disabled redirection host by ID so NPM serves its redirect again. Use update_redirection_host to edit destination or redirect code; list_redirection_hosts shows status. This changes NPM host state and applies its configuration. Returns the updated host object. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

enable_streamEnable StreamA

Enable a disabled TCP/UDP stream by ID so NPM forwards its incoming port again. Use update_stream to change ports or protocol flags; list_streams shows current status. This changes the stream state in NPM. Returns the updated stream object. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

find_host_by_domainFind Host By DomainA

Find proxy hosts, redirection hosts, and certificates serving a domain using exact or wildcard matching. This read-only lookup joins hosts to their assigned certificates. Returns compact host summaries with certificate details and certificates matching the domain.

Inputs: domain (required). Returns: object

get_access_listGet Access ListA

Fetch one access list by ID, including its client rules and basic-auth user metadata. Use this for detailed rules; use list_access_lists to discover IDs. NPM does not return stored item passwords, so password values cannot be read back. Returns the access-list object with name, clients, and user entries.

Inputs: id (required). Returns: object

get_proxy_hostGet Proxy HostA

Fetch one proxy host by ID, including its configured fields and current status. Use this for details about one host; use list_proxy_hosts to find IDs or inspect all hosts. This is read-only and does not reload Nginx. Returns the NPM host object, including domains, forwarding settings, and status.

Inputs: id (required). Returns: object

get_redirection_hostGet Redirection HostA

Fetch one redirection host by ID with its configured destination and status. Use this for a single redirect; use list_redirection_hosts to discover IDs or inspect all redirects. This is read-only and does not change NPM. Returns the host object with domains, destination, redirect code, and status.

Inputs: id (required). Returns: object

get_streamGet StreamA

Fetch one TCP/UDP stream by ID, including its forwarding ports and protocol settings. Use this for one stream; use list_streams to find IDs or inspect all streams. This is read-only and does not change NPM. Returns the stream object with incoming port, destination, protocol flags, and status.

Inputs: id (required). Returns: object

list_access_listsList Access ListsA

List access lists configured in NPM. Use this to find IDs before fetching, updating, or deleting a list; use get_access_list for one list with its rules. This is read-only and does not expose stored passwords. Returns access-list objects with IDs and names.

Inputs: no named parameters. Returns: result

list_certificatesList CertificatesA

List SSL certificates known to NPM, including expiry information when provided by NPM. Use this to inspect available certificates; create_letsencrypt_cert requests a new certificate and renew_certificate renews an existing one. This is read-only and makes no certificate request. Filter domain names by a case-insensitive substring with domain. Set compact=True to return only summary fields. Returns certificate objects with IDs, domains, provider, and expiry fields.

Inputs: domain, compact. Returns: result

list_expiring_certificatesList Expiring CertificatesA

List certificates expiring within the requested UTC time window, including certificates already expired, sorted by expiry. This read-only lookup also finds hosts using each certificate. Returns certificate summaries with days_left and proxy or redirection host references in used_by.

Inputs: days. Returns: result

list_proxy_hostsList Proxy HostsA

List proxy hosts configured in NPM, including their current status. Use this to find host IDs before get, update, enable, disable, or delete operations. It does not change NPM or request a certificate. Filter domain names by a case-insensitive substring with domain. Filter status with enabled. Set compact=True to return only summary fields. Returns a list of host objects with IDs, domains, forwarding settings, and status.

Inputs: domain, compact, enabled. Returns: result

list_redirection_hostsList Redirection HostsA

List configured redirection hosts and their current status. Use this to find IDs before fetching, changing, enabling, disabling, or deleting a redirect; proxy hosts handle upstream reverse proxying. This is read-only and does not request certificates. Filter domain names by a case-insensitive substring with domain. Filter status with enabled. Set compact=True to return only summary fields. Returns host objects with domains, destination, redirect code, and status.

Inputs: domain, compact, enabled. Returns: result

list_streamsList StreamsA

List configured TCP/UDP streams and their current status. Use this to find stream IDs before fetching, changing, enabling, disabling, or deleting a port forward. This is read-only and does not change NPM. Filter status with enabled. Set compact=True to return only summary fields. Returns stream objects with IDs, incoming and forwarding ports, protocols, and status.

Inputs: compact, enabled. Returns: result

renew_certificateRenew CertificateA

Request renewal of an existing certificate by ID. Use this for a certificate already managed by NPM; use create_letsencrypt_cert to request a new certificate. This triggers NPM certificate renewal processing and may contact the certificate provider. Returns the certificate operation result, including available certificate fields. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run. Returns: object

update_access_listUpdate Access ListA

Update writable fields on an existing access list by ID, including client rules and basic-auth users. Use this to edit access controls; use delete_access_list to remove a list. NPM receives the merged writable fields; item passwords are write-only and cannot be read back. Returns the updated list object with its name and rules. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), name, items, clients, +3 more. Returns: object

update_proxy_hostUpdate Proxy HostA

Update writable settings on an existing proxy host by ID. Use this to change routing or options; use enable_proxy_host or disable_proxy_host for status only. NPM receives the merged writable host fields, without requesting a certificate. Returns the updated host object with its ID and current settings. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run, ssl_forced, domain_names, +8 more. Returns: object

update_redirection_hostUpdate Redirection HostA

Update writable settings on an existing redirection host by ID. Use this to change domains, destination, or redirect behavior; use enable_redirection_host or disable_redirection_host for status only. NPM receives the merged writable fields. Returns the updated host object with its redirect settings. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run, ssl_forced, domain_names, +6 more. Returns: object

update_streamUpdate StreamA

Update writable port, destination, or protocol fields on an existing stream by ID. Use this to edit forwarding; use enable_stream or disable_stream to change status only. NPM receives the merged writable fields, preserving omitted values. Returns the updated stream object with its forwarding settings. Set dry_run=True to preview the exact request without changing NPM.

Inputs: id (required), dry_run, incoming_port, tcp_forwarding, +3 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 32 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes by resource and action, with descriptions that explicitly cross-reference alternatives. However, find_host_by_domain overlaps with domain-filtered list tools, and create_proxy_host vs create_proxy_host_with_letsencrypt could be confused if descriptions are skimmed.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern (list_, get_, create_, update_, delete_, enable_, disable_, find_). The only variation is the descriptive suffix in create_proxy_host_with_letsencrypt, which is still readable and consistent.

    Tool Count3/5

    32 tools is on the heavy side for the domain, though NPM manages several distinct resource types (proxy hosts, redirection hosts, streams, certificates, access lists). Some consolidation is possible (e.g., enable/disable could be status updates via update tools, and letsencrypt creation could be an option on create_proxy_host).

    Completeness4/5

    The surface covers full CRUD and lifecycle (create, get, list, update, delete, enable, disable) for proxy hosts, redirection hosts, streams, and access lists, plus certificate listing and creation. Gaps include certificate deletion (delete_certificate) and custom certificate import, and there is no get_certificate by ID (though listing may suffice).

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables management of Nginx Proxy Manager instances for configuring proxy hosts, requesting Let's Encrypt SSL certificates, and managing access lists. It allows users to control their web proxy infrastructure through natural language commands in MCP-compatible environments.
      50
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Self-hosted MCP proxy and aggregation platform. Register multiple upstream MCP servers and expose them through a single unified endpoint with namespace routing, multi-transport support (HTTP/SSE, stdio, OpenAPI→MCP), per-tool overrides, and a web admin UI.
      18
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for managing SWAG reverse-proxy configurations, including config generation, backups, logs, and health checks. Enables managing nginx subdomain configs for SWAG through a unified action router.
      7
      MIT