Every tool works in a workspace. If you name a workspace in your request, your AI tool uses it. If you do not, it reuses the workspace from earlier in the conversation, or asks you to pick one.
Pipelines and connectors
These six tools are in the Connectors & Logs permission group.get_current_pipeline: Gets the pipeline in a workspace: its connectors, the connections between them and resource usage.get_connector_config_deployed: Gets the configuration of a deployed connector. It can also open a deployed custom (Application) connector as an editable application.get_connector_configs_to_deploy: Lists the configuration fields you need to deploy a prebuilt connector.get_custom_connector_configs: Lists the configuration fields you need to deploy a custom connector or application.deploy_connector: Deploys a prebuilt or custom connector with the configuration you give it. This is the one tool that changes your environment.get_connector_logs: Gets the logs of a deployed connector.
Workspaces
ensure_workspace: Picks the workspace for the request: the one you named, the one already in use, or asks you to choose. It is in the Connectors & Logs permission group.get_all_workspaces: Lists all workspaces you can access in the connected environment. It is an internal tool that is always on. Your AI tool calls it on its own to find your workspace, and it cannot be disabled or paused.
Documentation
query_docs: Searches the Condense documentation and returns the most relevant sections. It can rerank the results. It is in the Documentation permission group.
The tool that changes your environment
deploy_connector is the tool that deploys a connector. Three things to know before you ask your AI tool to use it:
- Your role decides. You need a Condense role that lets you deploy in that workspace. Approving a connection does not add to it.
- An environment can block it. If an administrator set the environment to Strict read-only, any action that changes state is blocked, whatever your role allows. See Scope and permissions.
- You can leave it out. Clear
deploy_connectoron the approval page, or later on the AI Tools page, if an AI tool should only read.
get_connector_configs_to_deploy or get_custom_connector_configs, and read the values your AI tool is about to send.
Related
Ask Condense MCP
Example requests for each tool, and what each one needs.
Usage and limits
The limits that apply to all tools, shared by your organization.