# amitte/nginx-tools

> Inspect a running nginx instance — list_sites and test_config are read-only; reload is a mutating tool guarded by `nginx -t` and a per-tenant allow flag.

## Identity

- **Type:** mcp-server
- **Version:** 0.1.0
- **Trust tier:** official
- **License:** Apache-2.0
- **Authors:** Amitte Maintainers
- **Repo / bundle:** amitte/showcase
- **Canonical URL:** https://amitte.com/s/amitte/nginx-tools

## Tags

- **Capabilities:** sites-list, config-test, reload
- **Domains:** devtools, web-server, operations

## Evaluation

- **Adversarial score:** 95/100
- **Content score:** 82/100

## Endpoints

- **service-backed** `nginx-tools` → https://mcp.amitte.com/v1/nginx-tools/sse — Remote MCP server proxying to a registered nginx host's config + control surface. Targets Claude Desktop / Cursor / VS Code.
  - tool: `list_sites` — Read-only. List server blocks parsed from the running nginx config; returns server_name, listen ports, and upstream targets.
  - tool: `test_config` — Read-only. Run `nginx -t` against the live config and return the syntactic validation result.
  - tool: `reload` — WARNING: mutating. Issue `nginx -s reload` after a successful `nginx -t`. Refuses to run unless the tenant has the `allow_reload` flag set; audit-logged.

## Programmatic access

- Fetch JSON-RPC: `POST https://registry.amitte.com/rpc` with `{ "method": "fetch", "params": { "id": "amitte/nginx-tools" } }`
- Install via CLI: `amitte install amitte/nginx-tools`
- HTML page: https://amitte.com/s/amitte/nginx-tools

Last updated: 2026-06-08T14:20:09.283Z