Skip to main content
Glama

Set proxy auto-renew

set_proxy_auto_renew
DestructiveIdempotent

Enable or disable auto-renewal for a Standard dedicated proxy. When enabled, it renews about 12 hours before expiry and charges your balance; ask the user first.

Instructions

Turn auto-renew on or off for a Standard dedicated proxy. With it on, the proxy renews itself about 12 hours before expiry, charged to your balance at its renewal price. Ask the user before turning it on.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
enabledYes
proxy_idYesprx_... id of a dedicated proxy

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
proxyYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.2.1
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": {},
      +  "properties": {
      +    "proxy": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "auto_renew": {
      +          "type": "boolean"
      +        },
      +        "carrier": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "charged_price_cents": {
      +          "maximum": 9007199254740991,
      +          "minimum": -9007199254740991,
      +          "type": "integer"
      +        },
      +        "country": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "created_at": {
      +          "type": "string"
      +        },
      +        "data_bytes_used": {
      +          "maximum": 9007199254740991,
      +          "minimum": -9007199254740991,
      +          "type": "integer"
      +        },
      +        "data_gb_total": {
      +          "maximum": 9007199254740991,
      +          "minimum": -9007199254740991,
      +          "type": "integer"
      +        },
      +        "expires_at": {
      +          "type": "string"
      +        },
      +        "gateway": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "host": {
      +                  "type": "string"
      +                },
      +                "password": {
      +                  "type": "string"
      +                },
      +                "port": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": -9007199254740991,
      +                  "type": "integer"
      +                },
      +                "protocol": {
      +                  "enum": [
      +                    "http",
      +                    "socks5"
      +                  ],
      +                  "type": "string"
      +                },
      +                "socks_port": {
      +                  "anyOf": [
      +                    {
      +                      "maximum": 9007199254740991,
      +                      "minimum": -9007199254740991,
      +                      "type": "integer"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "username": {
      +                  "type": "string"
      +                },
      +                "username_geo_hint": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "host",
      +                "port",
      +                "protocol",
      +                "username",
      +                "password"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "lists": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "activation_note": {
      +                "type": "string"
      +              },
      +              "city": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "countries": {
      +                "anyOf": [
      +                  {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "country": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "created_at": {
      +                "type": "string"
      +              },
      +              "credentials": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {},
      +                    "properties": {
      +                      "host": {
      +                        "type": "string"
      +                      },
      +                      "password": {
      +                        "type": "string"
      +                      },
      +                      "port": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      "protocol": {
      +                        "type": "string"
      +                      },
      +                      "username": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "host",
      +                      "port",
      +                      "protocol",
      +                      "username",
      +                      "password"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "entries": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "format": {
      +                "type": "string"
      +              },
      +              "id": {
      +                "type": "string"
      +              },
      +              "isp": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "network": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "proxy_id": {
      +                "type": "string"
      +              },
      +              "region": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "rotation_mode": {
      +                "type": "string"
      +              },
      +              "rotation_period_seconds": {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              "zip": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "proxy_id",
      +              "name",
      +              "rotation_period_seconds",
      +              "rotation_mode",
      +              "format",
      +              "credentials",
      +              "entries",
      +              "activation_note",
      +              "created_at"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "next_renewal_price_cents": {
      +          "anyOf": [
      +            {
      +              "maximum": 9007199254740991,
      +              "minimum": -9007199254740991,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "plan_id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "rotation_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "status": {
      +          "enum": [
      +            "provisioning",
      +            "active",
      +            "expired",
      +            "refunded",
      +            "exhausted"
      +          ],
      +          "type": "string"
      +        },
      +        "type": {
      +          "enum": [
      +            "shared",
      +            "dedicated_standard",
      +            "dedicated_premium"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "status",
      +        "data_gb_total",
      +        "data_bytes_used",
      +        "charged_price_cents",
      +        "expires_at",
      +        "gateway",
      +        "lists"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "proxy"
      +  ],
      +  "type": "object"
      +}
  2. Changed2 schema fields changedv1.1.8
    • addedInput schema / properties / proxy_id / description
      Added value: +"prx_... id of a dedicated proxy"
    • addedInput schema / properties / proxy_id / pattern
      Added value: +"^(?:prx_[A-Za-z0-9_-]{1,64}|PRX[A-Za-z0-9]{1,32})$"
  3. Addedv1.1.7

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and idempotentHint=true, so the safety profile is partly covered. The description adds real value beyond that: renewal fires ~12 hours before expiry and is charged to balance at renewal price, plus a required user-confirmation step. It omits what happens on payment failure or how to undo it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with the action, followed by the behavioral consequence and the safety directive. No filler; every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists and annotations cover the mutation safety profile, so the description need not explain return values. Combined with scope, timing, billing, and the confirmation requirement, it is nearly complete for a two-parameter toggle, missing only failure/undo behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 50% (proxy_id documented with pattern, enabled undocumented), but the description supplies the semantics of enabled by spelling out the on/off consequence (auto-renew and balance charge). That compensates for the gap, though it adds nothing about proxy_id constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (turn on/off) and resource (auto-renew) scoped to 'a Standard dedicated proxy', which distinguishes it from renew_proxy and toggle_auto_renew. An agent can identify the exact effect without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear usage directive ('Ask the user before turning it on') and implicitly restricts scope to Standard dedicated proxies, which acts as an exclusion. It does not name alternatives such as renew_proxy for one-off manual renewal, so it falls short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.