Detach an agent MCP server
detach_agent_mcp_serverDetach an MCP server or connector from an agent to remove its access. Idempotent, so detaching an unattached server returns detached: false instead of an error.
Instructions
Detach an MCP server (connector) from an agent. This is idempotent — detaching a server that isn't attached returns detached: false rather than an error.
Explicit confirmation is required for this exact account operation. Runs can spend credits or trigger downstream actions; never resubmit unknown outcomes automatically.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_id": "<agent_id>",
"server_id": "<server_id>"
},
"name": "detach_agent_mcp_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Named private Gumloop account; selects private credentials and user/team identity. | |
| confirm | No | Set true only when the user asked for exactly this action. | |
| agent_id | Yes | ID of the agent. Also accepts the reserved aliases `gumball` and `analytics`. | |
| server_id | Yes | ID of the MCP server to detach. |