Agency Saas Deprecated Bulk Disable Locations

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

DESTRUCTIVEghl.agency_saas_deprecated_bulk_disable_locations

• Contract tier: legacy
• Risk: destructive
• Catalog version: 2026-07-12.2
• Descriptor hash: 1ba83890b467c7d0241caa0b8ca807a1ce099cda41406e7e078ee57653ffa80f

Deprecated public API path for disabling SaaS for multiple GHL locations in an agency company. GHL category: Launchpad / Saas. Requires an agency PIT token and company ID. Agency API is only available on the $497/mo Pro SaaS plan. This destructive agency SaaS operation can pause, disable, or otherwise materially affect SaaS access. Use only with explicit user confirmation and disposable fixtures during validation. This tool uses a deprecated GHL public API path and is exposed only for parity/backward compatibility.

Request Body

{
  "jsonrpc": "2.0",
  "id": "ghl-agency-saas-deprecated-bulk-disable-locations-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.agency_saas_deprecated_bulk_disable_locations",
    "arguments": {
      "body": {},
      "query": {},
      "companyId": "companyId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "properties": {
    "body": {
      "type": "object",
      "description": "Request body for this official GHL SaaS endpoint, using only fields documented by GHL.",
      "additionalProperties": true
    },
    "query": {
      "type": "object",
      "description": "Optional GHL-supported query parameters for this SaaS endpoint, such as Stripe customer/subscription identifiers or pagination/filter fields from the official docs.",
      "additionalProperties": true
    },
    "companyId": {
      "type": "string",
      "description": "Agency/company ID. In public runtime this normally comes from x-ghl-company-id; otherwise defaults to AGENCY_COMPANY_ID when configured."
    },
    "confirmApply": {
      "type": "string",
      "description": "Required for destructive SaaS operations. Set exactly to \"CONFIRM APPLY\" only after the user explicitly confirms the change."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the GHL MCP operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Tool-specific GHL or local navigation result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe execution, routing, and timing metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe error details when ok is false; credential values are never returned."
    }
  },
  "description": "Normalized GHL MCP response envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "ghl-agency-saas-deprecated-bulk-disable-locations-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.agency_saas_deprecated_bulk_disable_locations",
    "arguments": {
      "body": {},
      "query": {},
      "companyId": "companyId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "ghl-agency-saas-deprecated-bulk-disable-locations-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.agency_saas_deprecated_bulk_disable_locations",
    "arguments": {
      "body": {},
      "query": {},
      "companyId": "companyId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "ghl-agency-saas-deprecated-bulk-disable-locations-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.agency_saas_deprecated_bulk_disable_locations",
    "arguments": {
      "body": {},
      "query": {},
      "companyId": "companyId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool ghl.agency_saas_deprecated_bulk_disable_locations executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}