Tools reference
Integrations
What this workspace has connected, and what it could connect to.
With these tools an assistant can answer "can you talk to X?" accurately: what the workspace has connected and whether each connection is healthy, and everything the desk could connect to.
| Tool | What it does | Role needed | Changes data? |
|---|---|---|---|
list_integrations | Lists what this workspace has connected, and whether each is healthy | admin | read-only |
list_integration_catalog | Lists everything this desk could connect to | viewer | read-only |
Source: _TOOLS in services/runtime/src/runtime/mcp/tools.py, handlers
_list_integrations and _list_integration_catalog.
Neither tool sends the client a read-only hint. Both read and only read.
list_integrations
- Admin only, because connection state names the systems the desk can reach.
- Secrets are never returned.
list_integration_catalog
- Input:
include_coming_soon, optional. It defaults to true, so integrations that are not available yet are included unless you sendfalse. - The catalogue is the same for every workspace. It says what exists, not what
this workspace has connected; use
list_integrationsfor that.
Source: _list_integration_catalog in
services/runtime/src/runtime/mcp/tools.py.