Home / Servers / Square API / bulk_swap_plan
BulkSwapPlan
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
BulkSwapPlan Schedules a plan variation change for all active subscriptions under a given plan variation. For more information, see Swap Subscription Plan Variations. [POST /v2/subscriptions/bulk-swap-plan]
Name on the gateway: square_api__bulk_swap_plan · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
new_plan_variation_id required | string | The ID of the new subscription plan variation. This field is required. |
old_plan_variation_id required | string | The ID of the plan variation whose subscriptions should be swapped. Active… |
location_id required | string | The ID of the location to associate with the swapped subscriptions. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "square_api__bulk_swap_plan",
"arguments": {
"new_plan_variation_id": "…",
"old_plan_variation_id": "…",
"location_id": "…"
}
}Or connect the Square API server directly, which lists 308 tools including this one:
claude mcp add --transport http hj-square-api https://mcp.hjlabs.in/mcp/square-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the bulkswapplan tool with new_plan_variation_id set to ….