manage_account_state

Control email account operations: pause sending, resume activity, manage warmup processes, or test connection vitals to diagnose issues.

Instructions

Manage account state: pause, resume, enable/disable warmup, or test vitals.

Actions:

pause: Stop all sending from this account
resume: Re-enable sending
enable_warmup: Start warmup process
disable_warmup: Stop warmup process
test_vitals: Test IMAP/SMTP connectivity

Use test_vitals to diagnose connection issues.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`params`	Yes

Implementation Reference

src/instantly_mcp/tools/accounts.py:166-202 (handler)

The core handler function implementing the manage_account_state tool. It handles different actions (pause, resume, enable/disable warmup, test vitals) by making appropriate API calls to the Instantly.ai V2 API.

async def manage_account_state(params: ManageAccountStateInput) -> str:
    """
    Manage account state: pause, resume, enable/disable warmup, or test vitals.
    
    Actions:
    - pause: Stop all sending from this account
    - resume: Re-enable sending
    - enable_warmup: Start warmup process
    - disable_warmup: Stop warmup process
    - test_vitals: Test IMAP/SMTP connectivity
    
    Use test_vitals to diagnose connection issues.
    """
    client = get_client()
    email_encoded = quote(params.email, safe="")
    
    action_endpoints = {
        "pause": f"/accounts/{email_encoded}/pause",
        "resume": f"/accounts/{email_encoded}/resume",
        "enable_warmup": "/accounts/warmup/enable",
        "disable_warmup": "/accounts/warmup/disable",
        "test_vitals": "/accounts/test/vitals",
    }
    
    endpoint = action_endpoints[params.action]
    
    # Different actions have different body requirements
    if params.action in ["pause", "resume"]:
        result = await client.post(endpoint)
    elif params.action in ["enable_warmup", "disable_warmup"]:
        # V2 API expects an array of emails for warmup enable/disable
        result = await client.post(endpoint, json={"emails": [params.email]})
    else:  # test_vitals
        # V2 API expects an array of emails for test vitals
        result = await client.post(endpoint, json={"emails": [params.email]})
    
    return json.dumps(result, indent=2)

src/instantly_mcp/models/accounts.py:117-126 (schema)

Pydantic BaseModel defining the input schema for the manage_account_state tool, including required 'email' and 'action' fields.

class ManageAccountStateInput(BaseModel):
    """Input for managing account state (pause, resume, warmup control, vitals test)."""
    
    model_config = ConfigDict(str_strip_whitespace=True, extra="ignore")
    
    email: str = Field(..., description="Account email")
    action: Literal["pause", "resume", "enable_warmup", "disable_warmup", "test_vitals"] = Field(
        ..., description="Action to perform"
    )

src/instantly_mcp/server.py:73-73 (registration)
MCP tool annotation in the TOOL_ANNOTATIONS dictionary specifying that manage_account_state is non-destructive, used during dynamic registration of all tools.
```
"manage_account_state": {"destructiveHint": False},
```
src/instantly_mcp/tools/accounts.py:223-230 (registration)
The ACCOUNT_TOOLS list exports the manage_account_state function for inclusion in get_all_tools(), enabling its registration in the MCP server.
```
ACCOUNT_TOOLS = [
    list_accounts,
    get_account,
    create_account,
    update_account,
    manage_account_state,
    delete_account,
]
```

Instantly MCP Server