tor_new_identity
Request a new Tor circuit to get a different exit IP, changing your apparent location. Verifies IP change and handles rate-limiting automatically.
Instructions
Request a new Tor circuit to get a different exit IP.
Changes your apparent location and IP address by requesting a new circuit from the Tor daemon. Requires the Tor control port (9051). Rate-limited to once per 10 seconds by Tor itself.
Args: params (TorCircuitInput): Validated input containing: - verify (bool): Check if IP actually changed (default: True) - response_format (ResponseFormat): 'json' or 'markdown'
Returns: str: Circuit rotation result.
JSON schema:
{
"success": bool,
"old_ip": str | null,
"new_ip": str | null,
"ip_changed": bool | null,
"waited_seconds": float (only if rate-limited)
}Examples: - Use when: "Get a new exit IP" -> default params - Use when: "A site rate-limited me" -> default params - Use when: "I need to appear from a different location" -> default params - Don't use when: You just need to check current IP (use tor_check_anonymity)
Error Handling: - stem not installed: Returns pip install instruction - Control port not enabled: Returns torrc configuration hint - Rate-limited: Waits automatically (max 10s), reports wait time
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |