MCP Tools Reference
NeXuS exposes 8 MCP tools across three modules: containers, services, and logs.
Container Tools
nexus_list_containers
List all NeXuS Docker containers with status, CPU%, memory, and network I/O.
| Property | Value |
|---|---|
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
Input:
| Parameter | Type | Default | Description |
|---|---|---|---|
filter | "all" | "running" | "stopped" | "all" | Which containers to show |
Example output:
NEXUS CONTAINERS (15/17 running)
────────────────────────────────────────────────────────────
● frontend running CPU:0.15% MEM:128MiB / 512MiB
● api running CPU:0.32% MEM:96MiB / 256MiB
● auth running CPU:0.08% MEM:64MiB / 256MiB
○ test-container exited CPU:— MEM:—
nexus_container_stats
Get detailed CPU, memory, network, and block I/O stats for a specific container.
| Property | Value |
|---|---|
| Read-only | Yes |
| Destructive | No |
Input:
| Parameter | Type | Description |
|---|---|---|
name | string | Container short name (e.g., "auth", "api") |
Example output:
STATS: nexus-auth
CPU: 0.08%
Memory: 64MiB / 256MiB (25.00%)
Network: 1.2MB / 3.4MB
Block: 12MB / 0B
PIDs: 12
nexus_restart_container
Restart a NeXuS container by name. The nexus- prefix is added automatically.
| Property | Value |
|---|---|
| Read-only | No |
| Destructive | No |
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Container short name (e.g., "auth") |
reason | string | No | Why you are restarting (for the log) |
nexus_stop_container
Stop a running container. Requires explicit confirmation.
| Property | Value |
|---|---|
| Read-only | No |
| Destructive | Yes |
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Container short name |
confirm | "yes" | Yes | Must be "yes" to confirm |
Service Tools
nexus_health_check
Ping all NeXuS public endpoints and return HTTP status codes. Returns 200=ok, 302=redirect (normal for Grafana), 502=container down.
| Property | Value |
|---|---|
| Read-only | Yes |
| Open-world | Yes (makes HTTP requests) |
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
service | string | No | Check one specific service, or omit for all |
Checked services: frontend, api, auth, cms, cdn, cache, waf, ai-gateway, grafana, mcp
Example output:
HEALTH CHECK (10/10 up)
───────────────────────────────────────────────────────
✓ frontend 200 https://nexus.sebhosting.com
✓ api 200 https://api.sebhosting.com/health
✓ auth 200 https://auth.sebhosting.com/health
✓ grafana 302 https://grafana.sebhosting.com
nexus_system_overview
Get a full system overview: container counts, host memory, load average, Docker version.
| Property | Value |
|---|---|
| Read-only | Yes |
Example output:
NEXUS SYSTEM OVERVIEW
────────────────────────────────────
Containers: 15 running, 2 stopped (17 total)
Docker: v29.2.1 · 29 images
Load avg: 0.95 (1m) / 1.20 (5m)
Memory: 2% used
1.0GB / 50.0GB
Log Tools
nexus_get_logs
Fetch the last N log lines from a container.
| Property | Value |
|---|---|
| Read-only | Yes |
Input:
| Parameter | Type | Default | Description |
|---|---|---|---|
name | string | — | Container short name |
lines | number | 50 | Lines to return (5–200) |
since | string | — | Time filter (e.g., "10m", "1h") |
nexus_search_logs
Search container logs for a specific string or error pattern (case-insensitive).
| Property | Value |
|---|---|
| Read-only | Yes |
Input:
| Parameter | Type | Default | Description |
|---|---|---|---|
name | string | — | Container short name |
pattern | string | — | Text to search for (2–100 chars) |
lines | number | 200 | How many recent lines to search (50–1000) |
Example output:
SEARCH: "error" in nexus-auth — 3 matches
──────────────────────────────────────────────────
2026-02-14T06:00:01Z Login error: invalid credentials
2026-02-14T06:12:33Z Register error: duplicate email
2026-02-14T06:19:07Z DB connection error: timeout