Setup & Connection Status
setup_statusRead-only
Diagnoses the mailpouch install end-to-end and returns the single next action to connect: checks credentials, Proton Bridge reachability, and agent approval. Works before setup is complete.
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 |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | Overall install state — pick the next step from this. | |
| configured | Yes | A username and Bridge password are configured. | |
| bridgeReachable | Yes | Both IMAP and SMTP Bridge ports accept TCP connections. | |
| configExists | 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. | |
| username | No | ||
| credentialStorage | No | ||
| imap | No | ||
| smtp | No | ||
| insecureTls | No | TLS validation is disabled (no pinned Bridge cert). | |
| grantStatus | No | This agent's per-agent grant state, or null when the local-agent gate is off. | |
| nextStep | Yes | The single most-important action to take next. |