Setup & Connection Status
setup_statusRead-only
Diagnoses your mailpouch installation end-to-end and returns the single next action to get connected: check credentials, Proton Bridge reachability, and agent access approval. Works before credentials or approval.
Instructions
CALL THIS FIRST. Diagnoses the mailpouch install end-to-end and returns the single next action to get connected: whether credentials are configured, whether Proton Bridge is reachable, and whether this agent's access has been approved. Always available — works even before the agent is approved or credentials are set. Use get_connection_status afterwards for live IMAP/SMTP auth health.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | No | Optional account ID to route this call to (multi-account configs). Omit to use the active account. Configured account IDs are listed in the settings UI (Accounts tab). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| imap | No | ||
| smtp | No | ||
| state | Yes | Overall install state — pick the next step from this. | |
| nextStep | Yes | The single most-important action to take next. | |
| username | No | ||
| configPath | No | Path to the config file (default ~/.mailpouch.json; overridable via the MAILPOUCH_CONFIG env var). Redacted to '~/.mailpouch.json' for callers whose grant is not yet active. | |
| configured | Yes | A username and Bridge password are configured. | |
| grantStatus | No | This agent's per-agent grant state, or null when the local-agent gate is off. | |
| insecureTls | No | TLS validation is disabled (no pinned Bridge cert). | |
| configExists | No | ||
| bridgeReachable | Yes | Both IMAP and SMTP Bridge ports accept TCP connections. | |
| credentialStorage | No |