> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ishlabs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# connect tools

> MCP tool reference for the connect domain.

## `connect_status`

**Tier:** read-only · **Tags:** connect, read

Check whether the current user has an active `ish connect` tunnel
registered with the Ish backend. Works in hosted MCP mode (read-only;
unlike the `local-only` `connect` verb, it just reads backend state).

Call before dispatching `study_run` / `ask_run` against
locally-served iterations (`platform="code"` or a `localhost` /
RFC1918 URL): a missing tunnel makes the run fail fast rather than
stalling on a connection refused inside the cloud browser. See
`docs_get("guides/mcp-add")`.

**Returns**:

* tunnel active → `{"active": True, "tunnel_url": <str>,
  "local_port": <int>, "last_heartbeat": <iso>, "created_at": <iso>}`
* no tunnel → `{"active": False}`

Other backend errors (auth, network, 5xx) propagate as the normal
`IshApiError` envelope.

*No parameters.*