pbs_remote_create
Creates a remote PBS sync-source to enable backup synchronization between Proxmox servers. Dry-run by default; set confirm=True to apply.
Instructions
MUTATION (MEDIUM): create a PBS remote sync-source. Dry-run by default.
PRIVATE PASSWORD REDACTION: 'password' is a remote user credential. It is UNCONDITIONALLY redacted from the server-side plan, change, current state, detail, and audit ledger. Only {"password":"[redacted]"} is recorded on those surfaces. L02 NOTE: the MCP tool-call itself is a structured JSON object in which 'password' appears as a plain parameter — it is visible in the LLM's output token stream and in any MCP client log. This is an MCP-protocol property; server-side redaction protects the ledger only. The TLS cert 'fingerprint' is PUBLIC data — it is NOT redacted.
No rollback primitive — revert by deleting the remote (pbs_remote_delete). confirm=True to execute.
POST /config/remote Smoke-confirm: auth-id vs authid param name; port param name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Hostname or IP address of the remote PBS server. | |
| name | Yes | Name for the new PBS remote sync-source. | |
| port | No | TCP port of the remote PBS API; defaults to the standard PBS port if omitted. | |
| auth_id | Yes | PBS auth ID (user@realm or api-token) used to authenticate to the remote. | |
| comment | No | Free-text comment/description for the remote. | |
| confirm | No | Set True to execute; False (default) only returns the dry-run plan. | |
| password | Yes | Password or API token secret for auth_id; redacted from all plans/logs/ledger. | |
| fingerprint | No | TLS cert fingerprint of the remote PBS server (public data, not redacted). | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |