get_account_details

Retrieve account details including warmup status, SMTP settings, and campaign eligibility for email marketing management.

Instructions

Get detailed information about a specific account including warmup status, SMTP settings, and eligibility for campaigns.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`email`	Yes	Email address of the account to inspect

Implementation Reference

src/handlers/tool-executor.ts:1044-1067 (handler)

Handler implementation for 'get_account_details' tool (backward compatibility alias). Checks for required 'email' argument and fetches account details via API call to `/accounts/{email}`.

case 'get_account':
case 'get_account_details':  // Backward compatibility
case 'get_account_info': {   // Backward compatibility
  console.error(`[Instantly MCP] 👤 Executing get_account (called as: ${name})...`);

  if (!args.email) {
    throw new McpError(ErrorCode.InvalidParams, 'Email parameter is required');
  }

  const accountResult = await makeInstantlyRequest(`/accounts/${args.email}`, {}, apiKey);

  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify({
          success: true,
          account: accountResult,
          message: 'Account details retrieved successfully'
        }, null, 2)
      }
    ]
  };
}

src/validation.ts:577-579 (schema)
Zod input schema for get_account_details: requires a valid 'email' field.
```
export const GetAccountDetailsSchema = z.object({
  email: EmailSchema
});
```

src/validation.ts:794-796 (helper)

Helper function to validate input arguments for get_account_details using Zod schema and convert errors to MCP format.

export function validateGetAccountDetailsData(args: unknown): z.infer<typeof GetAccountDetailsSchema> {
  return validateWithSchema(GetAccountDetailsSchema, args, 'get_account_details');
}

src/validation.ts:845-845 (helper)
Registration of the get_account_details validator in the central TOOL_VALIDATORS mapping object.
```
'get_account_details': validateGetAccountDetailsData,
```

src/tools/account-tools.ts:28-40 (registration)

Tool definition/registration for consolidated 'get_account' tool (includes get_account_details functionality per comment at line 6). Used in TOOLS_DEFINITION.

{
  name: 'get_account',
  title: 'Get Account',
  description: 'Get account details, warmup status, and campaign eligibility by email',
  annotations: { readOnlyHint: true },
  inputSchema: {
    type: 'object',
    properties: {
      email: { type: 'string', description: 'Account email address' }
    },
    required: ['email']
  }
},

Instantly MCP Server